Freigeben über


RoleManagerSection-Klasse

Definiert Konfigurationseinstellungen, die zur Unterstützung der Rollenverwaltungsinfrastruktur von Webanwendungen verwendet werden.

Syntax

class RoleManagerSection : ConfigurationSectionWithCollection  

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der RoleManagerSection-Klasse verfügbar gemacht werden.

Name Beschreibung
Add (Hinzufügen) (Geerbt von ConfigurationSectionWithCollection.)
Clear (Geerbt von ConfigurationSectionWithCollection.)
Get (Geerbt von ConfigurationSectionWithCollection.)
GetAllowDefinition (Geerbt von ConfigurationSection.)
GetAllowLocation (Geerbt von ConfigurationSection.)
Remove (Geerbt von ConfigurationSectionWithCollection.)
RevertToParent (Geerbt von ConfigurationSection.)
SetAllowDefinition (Geerbt von ConfigurationSection.)
SetAllowLocation (Geerbt von ConfigurationSection.)

Eigenschaften

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die von der RoleManagerSection Klasse verfügbar gemacht werden.

Name Beschreibung
CacheRolesInCookie Ein boolean Lese-/Schreibwert. true, wenn die Rollen des aktuellen Benutzers in einem Cookie zwischengespeichert werden, andernfalls false. Der Standardwert ist false.
CookieName Ein string Lese-/Schreibwert, der den Namen des Cookies angibt, das zum Zwischenspeichern von Rollennamen verwendet wird. Der Standardname lautet .ASPXROLES.
CookiePath Ein string Lese-/Schreibwert, der den virtuellen Pfad des Cookies angibt, der zum Zwischenspeichern von Rollennamen verwendet wird. Der Standardwert ist „/“.
CookieProtection Eine sint32 Lese-/Schreibaufzählung, die das Cookie-Schutzschema angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
CookieRequireSSL Ein boolean Lese-/Schreibwert. true wenn für das Cookie, das zum Zwischenspeichern von Rollennamen verwendet wird, eine SSL-Verbindung (Secure Sockets Layer) erforderlich ist, um an den Server zurückgegeben zu werden; andernfalls false. Der Standardwert ist false.
CookieSlidingExpiration Ein boolean Lese-/Schreibwert. true wenn das Cookie, das zum Zwischenspeichern von Rollennamen verwendet wird, regelmäßig zurückgesetzt wird; andernfalls false. Der Standardwert ist true.
CookieTimeout Ein datetime Lese-/Schreibwert, der die Zeitspanne in Minuten angibt, bevor das Cookie, das zum Zwischenspeichern von Rollennamen verwendet wird, abläuft. Der Standardwert beträgt 30 Minuten.
CreatePersistentCookie Ein boolean Lese-/Schreibwert. true wenn Rollennamen über Browsersitzungen hinweg Cookie-persistent gemacht werden; andernfalls false. Die Standardeinstellung ist „false“.

Die CreatePersistentCookie Eigenschaft gibt an, ob das Cookie, das zum Zwischenspeichern von Rollennamen verwendet wird, ein persistentes Cookie sein soll, was bedeutet, dass das Cookie über Browsersitzungen oder ein sitzungsbasiertes Cookie verfügbar ist, was bedeutet, dass das Cookie verloren geht, wenn der Browser geschlossen wird. Der Standardwert ist false, der angibt, dass ein sitzungsbasiertes Cookie verwendet wird, um Rollennamen zwischenzuspeichern.
DefaultProvider Ein string Lese-/Schreibwert, der den Namen des Standardanbieters angibt, der zum Verwalten von Rollen verwendet wird. Der Standardwert ist "AspNetSqlRoleProvider". Diese Eigenschaft muss mit einem benannten Wert übereinstimmen, der in der Providers Eigenschaft angegeben ist. Eine leere Zeichenfolge ("") ist kein gültiger Name.
Domain Ein string Wert mit Lese-/Schreibzugriff, der den Namen der Domäne angibt, die dem Cookie zugeordnet ist, das zum Zwischenspeichern von Rollennamen verwendet wird. Der Standardwert ist eine leere Zeichenfolge (""). Wenn kein Wert angegeben wird, gibt die Domain Eigenschaft null zurück.
Enabled Ein boolean Lese-/Schreibwert. true wenn das Feature für die Rollenverwaltung ASP.NET aktiviert ist (d. h. es kann zur Laufzeit darauf zugegriffen werden); andernfalls false. Der Standardwert ist false.
Location (Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
MaxCachedResults Ein sint32 Lese-/Schreibwert, der die maximale Anzahl von Rollen angibt, die im Rollencookies zwischengespeichert ASP.NET. Der Standard ist 25.
Path (Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
Providers Ein ProvidersSettings-Wert, der Rollenverwaltungsanbieter angibt. Hinweis: Rollenverwaltungsanbieter sind Komponenten, die Zugriff auf die Rollentypen für eine Website bieten.
SectionInformation (Geerbt von ConfigurationSection.)

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die CookieProtection Eigenschaft angezeigt. Der Standardwert ist 3 (All).

Wert Schlüsselwort Beschreibung
0 None Gibt an, dass die Cookie-Informationen nicht geschützt sind. Die Informationen im Cookie werden im Klartext gespeichert und werden nicht überprüft, wenn die Informationen an den Server zurückgesendet werden.
1 Validation Stellt sicher, dass die Informationen im Cookie nicht geändert wurden, bevor die Informationen an den Server zurückgesendet werden.
2 Encryption Verschlüsselt die Informationen im Cookie.
3 All Gibt an, dass Validation als auch Encryption Werte verwendet werden, um die Informationen im Cookie zu schützen.

Vererbungshierarchie

ConfigurationSection

ConfigurationSectionWithCollection

RoleManagerSection

Anforderungen

type Beschreibung
Client - IIS 7.0 unter Windows Vista.
- IIS 7.5 unter Windows 7
- IIS 8.0 unter Windows 8
- IIS 10.0 unter Windows 10
Server - IIS 7.0 unter Windows Server 2008
- IIS 7.5 unter Windows Server 2008 R2
IIS 8.0 auf Windows Server 2012
- IIS 8.5 unter Windows Server 2012 R2
- IIS 10.0 auf Windows Server 2016
Produkt - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei WebAdministration.mof

Weitere Informationen

ConfigurationSectionWithCollection-Klasse
NameTypeElement-Klasse
ProvidersSettings-Klasse
CIM_DATETIME