providers Element for healthMonitoring (ASP.NET Settings Schema)

MSDN Library
.NET Development
.NET Framework 3.5
General Reference for the .NET Framework
ASP.NET Reference
ASP.NET Configuration File Syntax
ASP.NET Configuration Settings
system.web Element (ASP.NET Settings Schema)
healthMonitoring Element (ASP.NET Settings Schema)

add Element for providers for healthMonitoring (ASP.NET Settings Schema)
clear Element for providers for healthMonitoring (ASP.NET Settings Schema)
remove Element for providers for healthMonitoring (ASP.NET Settings Schema)

providers Element for healthMonitoring (ASP.NET Settings Schema)
This page is specific to:.NET Framework Version:2.0 3.03.54.0

.NET Framework General Reference

providers Element for healthMonitoring (ASP.NET Settings Schema)

Defines the health monitoring providers that are responsible for event processing.

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

<configuration> Element
  system.web Element (ASP.NET Settings Schema)
    healthMonitoring Element (ASP.NET Settings Schema)
      providers Element for healthMonitoring (ASP.NET Settings Schema)

<providers>
     <add... />
     <remove... />
     <clear />
</providers>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element	Description
add	Optional element. Specifies the name of the provider and the class that implements it.
clear	Optional element. Removes all health monitoring providers from the collection.
remove	Optional element. Removes the specified health monitoring provider from the collection.

Element

Description

add

Optional element.

Specifies the name of the provider and the class that implements it.

clear

Optional element.

Removes all health monitoring providers from the collection.

remove

Optional element.

Removes the specified health monitoring provider from the collection.

Parent Elements

Element	Description
configuration	Specifies the required 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.

Remarks

You can add as many providers as your application requires.

A provider processes health events. For details about how to map an event to a provider, see the eventMappings Element for healthMonitoring (ASP.NET Settings Schema) element.

If additional name value pairs are present, the provider must process those values.

Default Configuration

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

<providers>
     <add name="EventLogProvider" type="System.Web.Management.EventLogWebEventProvider,
System.Web,Version=2.0.0.0,Culture=neutral,PublicKeyToken=b03f5f7f11d50a3a" />
     <add ConnectionStringName="LocalSqlServer" 
          maxEventDetailsLength="1073741823" buffer="false" 
          bufferMode="Notification" name="SqlWebEventProvider" 
          type="System.Web.Management.SqlWebEventProvider,
System.Web,Version=2.0.0.0,Culture=neutral,PublicKeyToken=b03f5f7f11d50a3a" />
     <add name="WmiWebEventProvider" type="System.Web.Management.WmiWebEventProvider,
System.Web,Version=2.0.0.0,Culture=neutral,PublicKeyToken=b03f5f7f11d50a3a" />
</providers>

Example

The following code example shows how to add a provider.

<providers>
  <add name="WmiEventProvider"
     type="System.Web.Management.WebWmiEventProvider,
     System.Web,Version=1.2.3400.0,Culture=neutral,
     PublicKeyToken=b03f5f7f11d50a3a"/>
  <add name="SampleEventProvider"     
    type="Samples.AspNet.SampleEventProvider,SampleEventProvider,
    Version=0.0.0.0,Culture=neutral,PublicKeyToken=92029af6cf75bd7c,
    ProcessorArchitecture=Neutral"/>
</providers>

Element Information

Configuration section handler	System.Web.Configuration..::.HealthMonitoringSection
Configuration member	HealthMonitoringSection..::.Providers
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

Attributes

Child Elements

Parent Elements

Default Configuration

Tasks

Concepts

Reference

Other Resources