Reset method

Resets the entire response buffer to a defined state. All data written up to that point is discarded. In contrast to Response.Clear() this also applies for all headers, cookies and other settings.

Syntax

Response.Reset( [tlNoHeaders} )

Parameter

lNoHeaders

If you pass .T., only the content of the output buffer is cleared. HTTP headers and cookies keep their current values. Server.Transfer() uses this setting when you pass .T. as the lClear parameter. The content of a page is completely replaced. Cookies that, for instance, a previously executed a login page created remain unchanged.

If you pass .F. or no value at all, AFP clear the content of the output buffer, as well as, all cookies and HTTP headers.

Note

Following the reset, the response cookie returns an empty document of the type text/html without cookies or with an HTTP header added through Response.AddHeader().

Response.Reset() is used if unexpectedly an entirely different page is to be displayed. This occurs most frequently in error handling routines. Whenever you call a page through Response.Call(), there is an implicit call to Response.Reset(). The same applies for Server.Transfer(), whenever the previous responses need to be deleted.