RuleSettings クラス

.NET Framework クラス ライブラリ リファレンス

RuleSettings クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ASP.NET イベント規則を構成します。このクラスは継承できません。

名前空間: System.Web.Configuration
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 RuleSettings
    Inherits ConfigurationElement

Visual Basic (使用法)

Dim instance As RuleSettings

C#

public sealed class RuleSettings : ConfigurationElement

C++

public ref class RuleSettings sealed : public
 ConfigurationElement

J#

public final class RuleSettings extends ConfigurationElement

JScript

public final class RuleSettings extends
 ConfigurationElement

解説

イベント規則は、どのプロファイルを使用してどのイベントをどのプロバイダに対して発生させるかを決定します。

使用例

以下は構成ファイルからの抜粋です。RuleSettings クラスのプロパティに対して、宣言によって値を指定する方法を示しています。

<healthMonitoring>
    <rules>
        <add name="All Errors Default"
            eventName="All Errors"
            provider="EventLogProvider"
            profile="Default"
            minInterval="00:01:00" 
        />
        <add name="All Audits Default"
            eventName="All Audits"
            provider="SqlWebEventProvider"
            profile="Default"
            minInterval="00:00:30" 
        />
        <add name="Failure Audits Default"
            eventName="Failure Audits"
            provider="WmiWebEventProvider"
            profile="Critical"
            minInterval="00:00:30" 
        />
        <add name="Request Processing Errors"
            eventName="Request Processing Errors"
            provider="CriticalMailEventProvider"
            profile="Default"
        />
        <add name="Infrastructure Notifications"
            eventName="Infrastructure Errors"
            provider="CriticalMailEventProvider"
            profile="Critical"
        />
   </rules>
</healthMonitoring>

RuleSettings 型の値を作成して設定する方法を次のコード例に示します。このコード例は、HealthMonitoringSection クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Add a RuleSettings object to the Rules collection property.
Dim ruleSetting As RuleSettings = new
 RuleSettings("All Errors Default", _
    "All Errors", "EventLogProvider")
ruleSetting.Name = "All Errors Custom"
ruleSetting.EventName = "All Errors"
ruleSetting.Provider = "EventLogProvider"
ruleSetting.Profile = "Custom"
ruleSetting.MaxLimit = Int32.MaxValue
ruleSetting.MinInstances = 1
ruleSetting.MinInterval = TimeSpan.Parse("00:00:30")
ruleSetting.Custom = "MyEvaluators.MyCustomeEvaluator2, MyCustom.dll"
healthMonitoringSection.Rules.Add(ruleSetting)

C#

// Add a RuleSettings object to the Rules collection property.
RuleSettings ruleSetting = new RuleSettings("All Errors Default"
,
    "All Errors", "EventLogProvider");
ruleSetting.Name = "All Errors Custom";
ruleSetting.EventName = "All Errors";
ruleSetting.Provider = "EventLogProvider";
ruleSetting.Profile = "Custom";
ruleSetting.MaxLimit = Int32.MaxValue;
ruleSetting.MinInstances = 1;
ruleSetting.MinInterval = TimeSpan.Parse("00:00:30");
ruleSetting.Custom = "MyEvaluators.MyCustomeEvaluator2, MyCustom.dll";
healthMonitoringSection.Rules.Add(ruleSetting);

RuleSettings 型の値を取得して表示する方法を次のコード例に示します。このコード例は、HealthMonitoringSection クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Display contents of the Rules collection property
Console.WriteLine( _
    "Rules Collection contains {0} values:", healthMonitoringSection.Rules.Count)

' Display all elements.
For i As System.Int32 = 0 To
 healthMonitoringSection.Rules.Count -1
ruleSetting = healthMonitoringSection.Rules(i)
Dim name As String = ruleSetting.Name
Dim eventName As String
 = ruleSetting.EventName
Dim provider As String =
 ruleSetting.Provider
Dim profile As String =
 ruleSetting.Profile
Dim minInstances As Integer
 = ruleSetting.MinInstances
Dim maxLimit As Integer
 = ruleSetting.MaxLimit
Dim minInterval As TimeSpan = ruleSetting.MinInterval
Dim custom As String = ruleSetting.Custom
    Dim item As String =
 "Name='" & name & "', EventName='" &
 eventName & _
        "', Provider =  '" & provider & "', Profile
 =  '" & profile & _
        "', MinInstances =  '" & minInstances & "',
 MaxLimit =  '" & maxLimit & _
        "', MinInterval =  '" & minInterval.ToString()
 & "', Custom =  '" & custom & "'"
    Console.WriteLine("  Item {0}: {1}", i, item)
Next

C#

// Display contents of the Rules collection property
Console.WriteLine(
    "Rules Collection contains {0} values:", healthMonitoringSection.Rules.Count);

// Display all elements.
for (System.Int32 i = 0; i < healthMonitoringSection.Rules.Count;
 i++)
{
ruleSetting = healthMonitoringSection.Rules[i];
string name = ruleSetting.Name;
string eventName = ruleSetting.EventName;
string provider = ruleSetting.Provider;
string profile = ruleSetting.Profile;
int minInstances = ruleSetting.MinInstances;
int maxLimit = ruleSetting.MaxLimit;
TimeSpan minInterval = ruleSetting.MinInterval;
string custom = ruleSetting.Custom;
    string item = "Name='" + name + "', EventName='"
 + eventName +
        "', Provider =  '" + provider + "', Profile =  '" + profile
 +
        "', MinInstances =  '" + minInstances + "', MaxLimit =  '"
 + maxLimit +
        "', MinInterval =  '" + minInterval + "', Custom =  '"
 + custom + "'";
    Console.WriteLine("  Item {0}: {1}", i, item);
}

継承階層

System.Object
   System.Configuration.ConfigurationElement
    System.Web.Configuration.RuleSettings

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
RuleSettings メンバ
System.Web.Configuration 名前空間
HealthMonitoringSection クラス