PagesSection.Buffer Property

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Gets or sets a value that specifies whether .aspx pages and .ascx controls use response buffering.

public:
 property bool Buffer { bool get(); void set(bool value); };

[System.Configuration.ConfigurationProperty("buffer", DefaultValue=true)]
public bool Buffer { get; set; }

[<System.Configuration.ConfigurationProperty("buffer", DefaultValue=true)>]
member this.Buffer : bool with get, set

Public Property Buffer As Boolean

Property Value

Boolean

true if .aspx pages and .ascx controls use response buffering; otherwise, false. The default is true.

Attributes

ConfigurationPropertyAttribute

Examples

The following code example shows how to use the Buffer property.

// Get the current Buffer property value.
Console.WriteLine(
    "Current Buffer value: '{0}'", pagesSection.Buffer);

// Set the Buffer property to true.
pagesSection.Buffer = true;

' Get the current Buffer property value.
Console.WriteLine( _
    "Current Buffer value: '{0}'", pagesSection.Buffer)

' Set the Buffer property to true.
pagesSection.Buffer = True

Remarks

When response buffering is turned on, the page or control output is buffered until after the entire page or control is processed. Do not set Buffer to true if performance is a key consideration.