add Element for bufferMode for healthMonitoring (ASP.NET Settings Schema) 

Configures a buffer mode and adds it to the HealthBufferModeSettings collection.

This element is new in the .NET Framework version 2.0.

<add 
  name="buffer mode name"
  maxBufferSize="buffer size"
  maxFlushSize="maximum events per flush"
  urgentFlushThreshold="minimum threshold per flush"
  regularFlushInterval="time interval per flush"
  urgentFlushInterval="minimum time between flushes"
  maxBufferThreads="maximum number of flushing threads"
/> 

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute	Description
name	Required String attribute. Specifies the name for this buffer mode.
maxBufferSize	Required Int32 attribute. Specifies the maximum number of events that can be buffered. The value cannot be 0.
maxFlushSize	Required Int32 attribute. Specifies the maximum number of events per flush. The value must be between 1 and maxBufferSize.
urgentFlushThreshold	Required Int32 attribute. Specifies the minimum threshold per flush. The value must be less then or equal to maxBufferSize.
regularFlushInterval	Required TimeSpan attribute. Specifies the time interval per flush. The value cannot be 0.
urgentFlushInterval	Required TimeSpan attribute. Specifies the minimum time between flushes. The value must be between 0 and regularFlushInterval.
maxBufferThreads	Required Int32 attribute. Specifies the maximum number of flushing threads.

Child Elements

None.

Parent Elements

Element	Description
configuration	Specifies the root element in every configuration file that is used by the common language runtime and the .NET Framework applications.
system.web	Specifies the root element for the ASP.NET configuration section.
healthMonitoring	Configures an application for health monitoring.
bufferModes	Defines the buffering capabilities for a provider.

Remarks

Default Configuration

The following default add element is configured in the root Web.config file in the .NET Framework version 2.0.

<add name="Critical Notification" maxBufferSize="100" maxFlushSize="20"
     urgentFlushThreshold="1" regularFlushInterval="Infinite" urgentFlushInterval="00:01:00" 
     maxBufferThreads="1" />
<add name="Notification" maxBufferSize="300" maxFlushSize="20"
     urgentFlushThreshold="1" regularFlushInterval="Infinite" urgentFlushInterval="00:01:00" 
     maxBufferThreads="1" />
<add name="Analysis" maxBufferSize="1000" maxFlushSize="100" urgentFlushThreshold="100" 
     regularFlushInterval="00:05:00" urgentFlushInterval="00:01:00" 
     maxBufferThreads="1" />
<add name="Logging" maxBufferSize="1000" maxFlushSize="200" 
     urgentFlushThreshold="800" regularFlushInterval="00:30:00" urgentFlushInterval="00:05:00" 
     maxBufferThreads="1" />

Example

The following code example shows how to add a buffer mode.

<bufferModes>
  <add name="Critical Notification"
    maxBufferSize="100"
    maxFlushSize="20"
    urgentFlushThreshold="1"
    regularFlushInterval="Infinite"
    urgentFlushInterval="00:01:00"
    maxBufferThreads="1"
  />
</bufferModes>

Element Information

Configuration section handler	System.Web.Configuration.HealthMonitoringSection
Configuration member	System.Web.Configuration.BufferModesCollection
Configurable locations	Machine.config Root-level Web.config Application-level Web.config
Requirements	Microsoft Internet Information Services (IIS) version 5.0, 5.1, or 6.0 The .NET Framework version 2.0 Microsoft Visual Studio 2005

See Also

Tasks

How to: Lock ASP.NET Configuration Settings

Reference

healthMonitoring Element (ASP.NET Settings Schema)
bufferModes Element for healthMonitoring (ASP.NET Settings Schema)
clear Element for bufferModes for healthMonitoring (ASP.NET Settings Schema)
remove Element for bufferModes for healthMonitoring (ASP.NET Settings Schema)
System.Configuration
System.Web.Configuration

Concepts

ASP.NET Configuration Overview
ASP.NET Web Server Controls and Browser Capabilities
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios

Other Resources

ASP.NET Configuration Files
ASP.NET Configuration Settings
General Configuration Settings (ASP.NET)
ASP.NET Configuration API