RuleElement 类
将 Web 事件映射到运行状况监视提供程序。
语法
class RuleElement : CollectionElement
方法
此类不包含任何方法。
属性
下表列出了 RuleElement 类公开的属性。
| 名称 | 描述 |
|---|---|
Custom |
一个读/写 string 值，指定实现 System.Web.Management.IWebEventCustomEvaluator 接口的自定义类的完全限定类型。 默认值为空字符串("")。类型引用的构成方式如下（括号中的项不是必需的）：Namespace.Typename, Assemblyname[,] [Version=x,] [Culture=y,] [PublicKeyToken=z]（例如“ExampleNamespace.ExampleType, Example.Assembly, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%”）。 注意：此属性是在 .NET Framework 2.0 版中新提供的。 |
EventName |
一个读/写 string 值，指定 EventMappingSettings 类中的事件名称。 |
MaxLimit |
一个读/写 sint32 值，指定引发 EventName 属性中指定的事件的最大次数。 默认值为 2147483647（无限）。 |
MinInstances |
一个读/写 sint32 值，指定在向提供程序引发事件之前，EventName 属性中指定的事件发生的最小次数。 默认值为 1。 |
MinInterval |
一个读/写 datetime 值，指定 EventName 属性中指定类型的两个事件之间的最小间隔。 默认值为 0 秒。 注意：可以通过增大此属性的值来最大程度地减少对运行状况监视性能的影响。 |
Name |
一个只读 string 值，指定规则元素的名称。 键属性。 |
Profile |
一个读/写 string 值，指定事件配置文件（在 ProfileSettings 类中）用于确定事件的数量以及引发事件的频率。 |
Provider |
一个读/写 string 值，指定 ProviderSettings 类中的运行状况监视提供程序的名称。 |
子类
此类不包含子类。
注解
此类的实例作为 RuleSettings 类的 Rules 属性的成员公开。
运行状况监视事件（也称 Web 事件）在 Web 应用程序处理过程中引发，由提供程序（侦听器）使用，这些提供程序读取并记录与事件一起打包的信息。
可以通过配置新的 RuleElement 实例，为现有提供程序或自定义提供程序订阅 Web 事件。 可以通过将事件映射到此类中的事件提供程序来启用事件。 必须配置事件映射和提供程序设置，但除非连接事件和提供程序，否则不会引发事件。
若要禁用某个事件，可以从 RuleSettings 类中删除该事件。
继承层次结构
RuleElement
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上） |
| 服务器 | - IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上） |
| 产品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 文件 | WebAdministration.mof |
另请参阅
CollectionElement 类
EventMappingSettings 类
HealthMonitoringSection 类
ProfileSettings 类
ProviderSettings 类
RuleSettings 类
ASP.NET 运行状况监视概述
CIM_DATETIME