RuleSettings Klasse

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konfiguriert die ASP.NET-Ereignisregeln. Diese Klasse kann nicht vererbt werden.

public ref class RuleSettings sealed : System::Configuration::ConfigurationElement

public sealed class RuleSettings : System.Configuration.ConfigurationElement

type RuleSettings = class
    inherit ConfigurationElement

Public NotInheritable Class RuleSettings
Inherits ConfigurationElement

Vererbung: Object

ConfigurationElement
RuleSettings

Beispiele

Der folgende Konfigurationsdateiauszug zeigt, wie Die Eigenschaften der RuleSettings Klasse deklarativ angegeben werden.

<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>

Das folgende Codebeispiel zeigt, wie die Werte des RuleSettings Typs erstellt und festgelegt werden. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die HealthMonitoringSection Klasse bereitgestellt wird.

// 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);

' 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)

Das folgende Codebeispiel zeigt, wie die Werte des RuleSettings Typs abgerufen und angezeigt werden. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die HealthMonitoringSection Klasse bereitgestellt wird.

// 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);
}

' 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

Hinweise

Ereignisregeln bestimmen, welches Ereignis mit welchem Profil an welchen Anbieter ausgelöst wird.

Konstruktoren

Name	Beschreibung
RuleSettings(String, String, String, String, Int32, Int32, TimeSpan, String)	Initialisiert eine neue Instanz der Klasse, in der BufferModeSettings alle Werte angegeben werden.
RuleSettings(String, String, String, String, Int32, Int32, TimeSpan)	Initialisiert eine neue Instanz der Klasse, in der RuleSettings alle Werte außer denen der Custom Klasse angegeben werden.
RuleSettings(String, String, String)	Initialisiert eine neue Instanz der Klasse mithilfe von RuleSettings Standardeinstellungen. Der Name, der Ereignisname und der Anbieter werden jedoch angegeben.

Eigenschaften

Name	Beschreibung
CurrentConfiguration	Ruft einen Verweis auf die Instanz der obersten Ebene Configuration, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement Instanz gehört. (Geerbt von ConfigurationElement)
Custom	Dient zum Abrufen oder Festlegen des vollqualifizierten Typs IWebEventCustomEvaluatoreiner benutzerdefinierten Klasse, die implementiert wird.
ElementInformation	Ruft ein ElementInformation -Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement -Objekts enthält. (Geerbt von ConfigurationElement)
ElementProperty	Ruft das ConfigurationElementProperty-Objekt ab, das das ConfigurationElement-Objekt selbst darstellt. (Geerbt von ConfigurationElement)
EvaluationContext	Ruft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab. (Geerbt von ConfigurationElement)
EventName	Dient zum Abrufen oder Festlegen des Namens des Objekts, für das EventMappingSettings diese Regel gilt.
HasContext	Ruft einen Wert ab, der angibt, ob die CurrentConfiguration -Eigenschaft `null`ist. (Geerbt von ConfigurationElement)
Item[ConfigurationProperty]	Dient zum Abrufen oder Festlegen einer Eigenschaft oder eines Attributs dieses Konfigurationselements. (Geerbt von ConfigurationElement)
Item[String]	Dient zum Abrufen oder Festlegen einer Eigenschaft, eines Attributs oder eines untergeordneten Elements dieses Konfigurationselements. (Geerbt von ConfigurationElement)
LockAllAttributesExcept	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockAllElementsExcept	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockAttributes	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockElements	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockItem	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element gesperrt ist. (Geerbt von ConfigurationElement)
MaxLimit	Ruft ab oder legt fest, wie oft Ereignisse desselben Typs ausgelöst werden.
MinInstances	Dient zum Abrufen oder Festlegen der Mindestanzahl von Vorkommen desselben Ereignistyps, bevor das Ereignis an den Anbieter ausgelöst wird.
MinInterval	Dient zum Abrufen oder Festlegen des Mindestzeitintervalls zwischen zwei Ereignissen desselben Typs.
Name	Dient zum Abrufen oder Festlegen des Namens des RuleSettings Objekts.
Profile	Dient zum Abrufen oder Festlegen des Namens des Objekts, für das ProfileSettings diese Regel gilt.
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)
Provider	Dient zum Abrufen oder Festlegen des Namens des Objekts, für das ProviderSettings diese Regel gilt.

Methoden

Name	Beschreibung
DeserializeElement(XmlReader, Boolean)	Liest XML aus der Konfigurationsdatei. (Geerbt von ConfigurationElement)
Equals(Object)	Vergleicht die aktuelle ConfigurationElement Instanz mit dem angegebenen Objekt. (Geerbt von ConfigurationElement)
GetHashCode()	Ruft einen eindeutigen Wert ab, der die aktuelle ConfigurationElement Instanz darstellt. (Geerbt von ConfigurationElement)
GetTransformedAssemblyString(String)	Gibt die transformierte Version des angegebenen Assemblynamens zurück. (Geerbt von ConfigurationElement)
GetTransformedTypeString(String)	Gibt die transformierte Version des angegebenen Typnamens zurück. (Geerbt von ConfigurationElement)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt das ConfigurationElement-Objekt auf den Anfangszustand fest. (Geerbt von ConfigurationElement)
InitializeDefault()	Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement-Objekt zu initialisieren. (Geerbt von ConfigurationElement)
IsModified()	Gibt an, ob dieses Konfigurationselement seit dem letzten Speichern oder Laden geändert wurde, wenn es in einer abgeleiteten Klasse implementiert wurde. (Geerbt von ConfigurationElement)
IsReadOnly()	Ruft einen Wert ab, der angibt, ob das ConfigurationElement -Objekt schreibgeschützt ist. (Geerbt von ConfigurationElement)
ListErrors(IList)	Fügt der übergebenen Liste die Fehler der ungültigen Eigenschaft in diesem ConfigurationElement-Objekt und in allen Unterelementen hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut gefunden wird. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element auftritt. (Geerbt von ConfigurationElement)
OnRequiredPropertyNotFound(String)	Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird. (Geerbt von ConfigurationElement)
PostDeserialize()	Wird nach der Deserialisierung aufgerufen. (Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)	Wird vor der Serialisierung aufgerufen. (Geerbt von ConfigurationElement)
Reset(ConfigurationElement)	Setzt den internen Zustand des ConfigurationElement -Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen. (Geerbt von ConfigurationElement)
ResetModified()	Setzt den Wert der IsModified()-Methode auf `false` zurück, wenn sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Schreibt den Inhalt dieses Konfigurationselements in die Konfigurationsdatei, wenn es in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Schreibt die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Legt eine Eigenschaft auf den angegebenen Wert fest. (Geerbt von ConfigurationElement)
SetReadOnly()	Legt die IsReadOnly()-Eigenschaft für das ConfigurationElement-Objekt und alle Unterelemente fest. (Geerbt von ConfigurationElement)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Ändert das ConfigurationElement-Objekt, um alle Werte zu entfernen, die nicht gespeichert werden sollen. (Geerbt von ConfigurationElement)

Gilt für:

Weitere Informationen

HealthMonitoringSection

Feedback

War diese Seite hilfreich?