AuthorizationRule Klasse
Definition
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.
Mit der AuthorizationRule Klasse können Sie programmgesteuert auf den authorization Abschnitt einer Konfigurationsdatei zugreifen und diese ändern. Diese Klasse kann nicht vererbt werden.
public ref class AuthorizationRule sealed : System::Configuration::ConfigurationElement
public sealed class AuthorizationRule : System.Configuration.ConfigurationElement
type AuthorizationRule = class
inherit ConfigurationElement
Public NotInheritable Class AuthorizationRule
Inherits ConfigurationElement
- Vererbung
Beispiele
Das folgende Codebeispiel veranschaulicht die Verwendung der AuthorizationRule.
Note
Wenn Sie den Abschnitt credentials verwenden, befolgen Sie unbedingt die unter ASP.NET Authentication erläuterten Richtlinien. Für Skalierbarkeit und bessere Sicherheitsfunktionen wird empfohlen, die Anmeldeinformationen der Benutzer mithilfe einer externen Datenbank zu speichern. Weitere Informationen zum Erstellen sicherer ASP.NET Anwendungen finden Sie unter Curing Your ASP.NET Application and Building Secure ASP.NET Applications: Authentication, Authorization, and Secure Communication.
// Create an authorization rule object.
AuthorizationRuleAction action =
AuthorizationRuleAction.Deny;
AuthorizationRule authorizationRule =
new System.Web.Configuration.AuthorizationRule(action);
' Create an authorization rule object.
Dim action As AuthorizationRuleAction = _
AuthorizationRuleAction.Deny
Dim authorizationRule = _
New System.Web.Configuration.AuthorizationRule(action)
// Using the AuthorizationRuleCollection Add method.
// Set the action property.
authorizationRule.Action =
AuthorizationRuleAction.Allow;
// Define the new rule to add to the collection.
authorizationRule.Users.Add("userName");
authorizationRule.Roles.Add("admin");
authorizationRule.Verbs.Add("POST");
// Add the new rule to the collection.
authorizationSection.Rules.Add(authorizationRule);
' Using the AuthorizationRuleCollection Add method.
' Set the action property.
authorizationRule.Action = _
AuthorizationRuleAction.Allow
' Define the new rule to add to the collection.
authorizationRule.Users.Add("userName")
authorizationRule.Roles.Add("admin")
authorizationRule.Verbs.Add("POST")
' Add the new rule to the collection.
authorizationSection.Rules.Add(authorizationRule)
Hinweise
Die AuthorizationRule Klasse bietet eine Möglichkeit, programmgesteuert auf den authorization Abschnitt einer Konfigurationsdatei zuzugreifen und sie zu ändern.
Dieser Typ ist Teil einer Gruppe, die die Typen, die AuthorizationSectiondie AuthorizationRuleCollectionTypen AuthorizationRuleAction enthält.
Note
Die AuthorizationSection Konfigurationsinformationen können auf jeder Ebene in der Konfigurationshierarchie aktualisiert werden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| AuthorizationRule(AuthorizationRuleAction) |
Erstellt eine neue Instanz der AuthorizationRule Klasse mithilfe des übergebenen Objekts. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Action |
Ruft die Aktion ab oder legt sie AuthorizationRule fest. |
| 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) |
| 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) |
| HasContext |
Ruft einen Wert ab, der angibt, ob die CurrentConfiguration -Eigenschaft |
| 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) |
| Properties |
Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement) |
| Roles |
Ruft die Rollen ab, die der Ressource zugeordnet sind. |
| Users |
Ruft die Benutzer ab, die der Ressource zugeordnet sind. |
| Verbs |
Ruft die Verben ab, die der Ressource zugeordnet sind. |
Methoden
| Name | Beschreibung |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Liest XML aus der Konfigurationsdatei. (Geerbt von ConfigurationElement) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. |
| GetHashCode() |
Dient als Hashfunktion für dieses Objekt. |
| 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 |
| 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) |