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.

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.

Applies To

Response Object

See Also

• Response.Flush
• Response.End

Requirements

Platforms: Windows 2000 with IIS 5.0 installed, Windows XP with IIS 5.1 installed, Windows Server 2003 family with IIS 6.0 installed

Platform SDK Release: February 2003

What did you think of this topic?

Order a Platform SDK CD

  .