通过

healthMonitoring 的 providers 的 add 元素（ASP.NET 设置架构）

  • 项目

更新：2007 年 11 月

指定提供程序的名称和实现该提供程序的类。

<configuration> 元素
  system.web 元素（ASP.NET 设置架构）
    healthMonitoring 元素（ASP.NET 设置架构）
      healthMonitoring 的 providers 元素（ASP.NET 设置架构）
        healthMonitoring 的 providers 的 add 元素（ASP.NET 设置架构）

<!-- Default, WMIWebEventProvider and WebEventProvider syntax -->
<add   
   name="provider name"
   type="type reference" />

<!-- SQL Implementation Provider syntax -->
<add name="SqlEventProvider"
     type="System.Web.Management.SqlWebEventProvider, System.Web, 
Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
     connectionName="string"
     maxEventDetailLength="int" 
     commandTimeout="interval" 
     buffer="true|false" 
     bufferMode="string" />

<!-- Simple Mail Event and Templated Mail Web Event Providers syntax -->
<add name="MailEventProvider" 
     type="System.Web.Management.MailWebEventProvider,System.Web,
Version=%ASSEMBLY_VERSION%,Culture=neutral,PublicKeyToken=%MICROSOFT_PUBLICKEY%"
     from="string" 
     to="string; string" 
     cc=”string; string” 
     bcc="string; string" 
     priority="High|Normal|Low" 
     subjectPrefix="email subject prefix" 
     bodyHeader="email body header" 
     bodyFooter="email body footer" 
     separator="string" 
     template="string" (cannot be specified with the header/footer/separator) 
     maxSizeForSimpleMessage="number" 
     maxEventLengthForSimpleMessage="number" 
     maxEventCountForTemplateMessage="number" 
     maxMessagesPerNotification="number" 
     buffer="true|false" 
     bufferMode="string" />

属性和元素

下面几部分描述了属性、子元素和父元素。

属性

属性

说明

bcc

可选的 String 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 类。

定义要包括在密件抄送 (bcc) 列表中的用分号 (;) 分隔的收件人地址列表。

bodyFooter

可选的 String 属性。

仅适用于 SimpleMailWebEventProvider 属性。

指定要包括在电子邮件正文底部的文本（采用简单电子邮件的格式）。

说明：

此属性不能与 template 属性一起使用。

bodyHeader

可选的 String 属性。

仅适用于 SimpleMailWebEventProvider 属性。

指定要包括在电子邮件正文顶部的文本（采用简单电子邮件的格式）。

说明：

此属性不能与 template 属性一起使用。

buffer

必选的 Boolean 属性。

仅适用于 SqlWebEventProvider 类。

指定提供程序是使用缓冲还是立即将每个事件发送给收件人。

默认值为 false。

bufferMode

可选的 String 属性。

仅适用于 SQLWebEventProvider 属性。

指定提供程序使用的缓冲模式的名称（如果提供程序处于缓冲模式）。此名称必须引用 BufferModesCollection 集合中存在的现有缓冲模式之一；否则，将引发一个异常。如果打开了缓冲，则此属性必须存在。

cc

可选的 String 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 属性。

定义要包括在抄送 (cc:) 列表中的用分号 (;) 分隔的收件人地址列表。

commandTimeout

可选的 Int32 属性。

仅适用于 SQLWebEventProvider 属性。

指定在向成员资格数据源发出的命令超时之前等待的时间（秒）。SQL 提供程序在创建 SqlCommand 对象时，将使用该超时属性。默认情况下 ASP.NET 配置中并未设置该属性。因此，使用 ADO.NET 默认值 30 秒。如果设置了该属性，则 SQL 提供程序对向数据库发出的所有 SQL 命令必须使用配置的超时值。如果验证失败，则引发一个 System.Configuration.Provider.ProviderException 异常。

默认值为 30（ADO.NET 默认值）。

connectionStringName

必选的 String 属性。

仅适用于 SQLWebEventProvider 属性。

指定用于连接到数据库的字符串。

detailedTemplateErrors

可选的 Boolean 属性。

仅适用于 TemplatedMailWebEventProvider 属性。

指定当模板编译或运行期间出错时，是否通过电子邮件发送异常详细信息。

默认值为 false。

from

可选的 String 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 属性。

指定发件人的地址。

如果未指定此属性，则从 SMTP 邮件配置节继承。

maxEventDetailLength

可选的 Int32 属性。

仅适用于 SQLWebEventProvider 属性。

指定每个事件允许的事件详细信息的最大长度（字符数），如下所示：

  • 如果事件详细信息 (event.ToString()) 超过了此属性，则将事件详细信息截断为 maxEventDetailLength 长度的字符。

  • 如果为 0，则不为每个事件提供任何详细信息。

  • 如果为 Infinite，则不执行最大长度检查，可以包含完整的详细信息文本。

说明：

如果不限制事件详细信息长度，则此属性是一个潜在的缺陷。

maxEventLengthForSimpleMessage

可选的 Int32 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 属性。

指定每个事件允许的事件详细信息的最大长度（字符数），如下所示：

  • 如果事件详细信息 (event.ToString()) 超过了此属性，则将事件详细信息截断为 maxEventLengthForSimpleMessage 长度的字符。

  • 如果为 0，则通知中不包含事件详细信息。

  • 如果为 Infinite，则不设置事件详细信息长度的上限。

说明：

如果不限制消息大小，则此属性是一个潜在的缺陷。

默认值为 5000 个字符。

maxSizeForSimpleMessage

可选的 Int32 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 属性。

指定由提供程序发送的通知消息的最大大小（字节）。如果为 Infinite，则在简单模式下不执行邮件拆分。

说明：

此属性可能导致消息被电子邮件系统丢弃，这是一个潜在的缺陷。

默认值为 1024 KB。

maxEventCountForTemplateMessage

可选的 Int32 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 属性。

指定在模板模式下提供程序发送的每个通知消息中的最大事件数。如果为 Infinite，则不执行邮件拆分。

说明：

此属性可能导致消息被电子邮件系统丢弃，这是一个潜在的缺陷。

默认值为 100。

maxMessagesPerNotification

可选的 Int32 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 属性。

指定每个通知在事件拆分后可以包含的最大消息数。如果为 Infinite，则表示无限制。

说明：

此属性可能导致电子邮件大量涌进，这是一个潜在的缺陷。

默认值为 100。

name

必选的 String 属性。

指定提供程序的友好名称。

priority

可选的 String 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 属性。

设置电子邮件的优先级，它是 MailPriority 枚举的成员。

默认值为 Normal。

separator

可选的 String 属性。

仅适用于 SimpleMailWebEventProvider 属性。

指定要在各事件之间和各个节标头之后包括的文本（采用简单电子邮件的格式）。

说明：

此属性不能与 template 属性一起使用。

smtpAddresses

必选的 String 属性。

仅适用于 SimpleMailWebEventProvider 属性。

指定将事件通知发送到的用逗号分隔的电子邮件地址列表。若要为不同的配置文件事件使用不同的电子邮件地址组，则可以配置多个提供程序实例。

subjectPrefix

可选的 String 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 属性。

指定预置于电子邮件主题之前的字符串，并允许对于提供程序的每个实例，电子邮件具有自定义的主题。

说明：

此属性不能与 template 属性一起使用。

template

可选的 String 属性。

仅适用于 TemplatedMailWebEventProvider 属性。

指定用户提供的模板页 (.aspx)，以用于创建每个通知的邮件正文。

说明：

此属性不能与 bodyHeader、bodyFooter 和 separator 属性一起使用。

to

可选的 String 属性。

仅适用于 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 属性。

定义要包括在收件人 (To:) 列表中的用分号分隔的收件人地址列表。

type

必选的 String 属性。

指定对某个类的完全限定的程序集引用，该类实现 System.Configuration.Provider.ProviderBase 类。

子元素

无。

父元素

元素

说明

configuration

指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。

system.web

为 ASP.NET 配置节指定根元素。

healthMonitoring

针对运行状况监视配置应用程序。

providers

定义负责处理事件的运行状况监视提供程序。

备注

如果存在其他名称/值对，则提供程序必须处理它们。

默认配置

下面的默认 add 元素在 .NET Framework 版本 2.0 的根 Web.config 文件中配置。

<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>
  <add name="WmiEventProvider"
       type="System.Web.Management.WmiWebEventProvider,
     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>

元素信息

配置节处理程序

System.Web.Configuration.HealthMonitoringSection

配置成员

HealthMonitoringSection.Providers

可配置的位置

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

要求

Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0

Microsoft .NET Framework 2.0

Microsoft Visual Studio 2005

请参见

任务

如何：锁定 ASP.NET 配置设置

概念

ASP.NET 运行状况监视概述

ASP.NET 配置概述

ASP.NET Web 服务器控件和浏览器功能

保证 ASP.NET 配置的安全

ASP.NET 配置方案

参考

healthMonitoring 元素（ASP.NET 设置架构）

healthMonitoring 的 providers 元素（ASP.NET 设置架构）

healthMonitoring 的 providers 的 remove 元素（ASP.NET 设置架构）

healthMonitoring 的 providers 的 clear 元素（ASP.NET 设置架构）

WmiWebEventProvider

WebEventProvider

SimpleMailWebEventProvider

TemplatedMailWebEventProvider

SqlWebEventProvider

System.Configuration

System.Web.Configuration

System.Web.Management

其他资源

ASP.NET 配置文件

ASP.NET 配置设置

常规配置设置 (ASP.NET)

ASP.NET 配置 API