Response.Buffer

The Buffer property indicates whether to buffer page output. When page output is buffered, the server does not send a response to the client until all of the server scripts on the current page have been processed, or until the Flush or End method is called.

The Buffer property cannot be set after the server has sent output to the client. For this reason, the call to Response.Buffer should be the first line of the .asp file.

Syntax

Response.Buffer [**=**flag]

Parameters

• flag
  Specifies whether to buffer page output. It can be one of the following values.

  Value	Description
  FALSE	No buffering. The server sends output to the client as it is processed. This is the default value for versions of IIS 4.0 and earlier. For version 5.0 and later, the default value is TRUE.
  TRUE	The server does not send output to the client until all of the ASP scripts on the current page have been processed, or until the Flush or End method is called.

Applies To

Response Object

Remarks

If the current .asp file has Buffer set to TRUE and does not call the Response.Flush method, the server honors keep-alive requests made by the client. This saves time because the server does not have to create a new connection for each client request.

However, buffering prevents any of the response from being displayed to the client until the server has finished all script processing for the current page. For long scripts, this may cause a perceptible delay.

You can use the AspBufferingOn property in the metabase to set the default value for script buffering. For more information about using the metabase, see Using the IIS ADSI Provider.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

See Also