roleManager-Element (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Konfiguriert eine Anwendung für die Rollenverwaltung.
Dieses Element ist neu in .NET Framework, Version 2.0.
<roleManager
cacheRolesInCookie="true|false"
cookieName="name"
cookiePath="/"
cookieProtection="All|Encryption|Validation|None"
cookieRequireSSL="true|false "
cookieSlidingExpiration="true|false "
cookieTimeout="number of minutes"
createPersistentCookie="true|false"
defaultProvider="provider name"
domain="cookie domain">
enabled="true|false"
maxCachedResults="maximum number of role names cached"
<providers>...</providers>
</roleManager>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente für diesen Abschnitt beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
cacheRolesInCookie |
Optionales Boolean-Attribut. Gibt an, dass zuerst das Cookie überprüft wird, bevor mit dem Rollenanbieter die Rollenliste in der Datenquelle überprüft wird, wenn bei der Validierung festgestellt wird, dass ein Benutzer über eine bestimmte Rolle verfügt. true, wenn eine Rollennamenliste für den aktuellen Benutzer in einem Cookie zwischengespeichert wird; ansonsten false. Die Standardeinstellung ist false. |
cookieName |
Optionales String-Attribut. Gibt den Namen des Cookies an, in dem Rollennamen gespeichert werden. Der Standardwert ist ".ASPXROLES". |
cookiePath |
Optionales String-Attribut. Der Pfad des Rollennamen-Cookies. Der Standardwert ist "/". |
cookieProtection |
Optionales CookieProtection-Attribut. Gibt einen der CookieProtection-Enumerationswerte an. Der Standardwert ist All. |
cookieRequireSSL |
Optionales Boolean-Attribut. Gibt an, ob das Rollennamen-Cookie SSL benötigt, damit es an den Server gesendet werden kann. true, wenn das Rollennamen-Cookie SSL benötigt, damit es an den Server gesendet werden kann. Die Standardeinstellung ist false. |
cookieSlidingExpiration |
Optionales Boolean-Attribut. Gibt an, ob das Ablaufdatum und die Ablaufzeit des Rollennamen-Cookies regelmäßig zurückgesetzt werden. Falls true, wird für den Verfall des Cookies zu Beginn das aktuelle Datum und die aktuelle Uhrzeit plus dem Wert von CookieTimeout (in Minuten) festgelegt. Während der Benutzer die ASP.NET-Anwendung aktiv fortsetzt, werden Ablaufdatum und Ablaufzeit des Cookies automatisch aktualisiert, sobald mehr als die Hälfte des CookieTimeout-Werts ablaufen ist. Weitere Informationen finden Sie unter Expires. Die Standardeinstellung ist true. |
cookieTimeout |
Optionales Int32-Attribut. Die Anzahl der Minuten, bevor das Rollennamen-Cookie verfällt. Die Standardeinstellung ist "30" Minuten. |
createPersistentCookie |
Optionales Boolean-Attribut. Gibt an, ob es sich bei dem Rollennamen-Cookie um ein Sitzungscookie handelt, das nach dem Schließen des Browsers verloren geht. Im Fall von true handelt es sich bei dem Rollennamen-Cookie um ein dauerhaftes Cookie, das über mehrere Browsersitzungen hinweg verfügbar ist. Ablaufdatum und Ablaufzeit des dauerhaften Cookies sind auf das aktuelle Datum und die aktuelle Uhrzeit plus dem Wert von CookieTimeout (in Minuten) festgelegt. Die Standardeinstellung ist false. |
defaultProvider |
Optionales String-Attribut. Der Name des standardmäßigen Rollenanbieters. Weitere Informationen finden Sie unter Provider. Der Standardwert ist "AspNetSqlRoleProvider". |
domain |
Optionales String-Attribut. Gibt den Domain-Wert des Rollennamen-Cookies an. Standardeinstellung ist der Standardwert der HttpCookie-Eigenschaft, also eine leere Zeichenfolge (""). |
enabled |
Optionales Boolean-Attribut. Gibt an, ob die Rollenverwaltung aktiviert werden soll. Im Fall von true ist die Rollenverwaltung aktiviert. Der Standardwert in der Datei Machine.config ist false. |
maxCachedResults |
Optionales Int32-Attribut. Gibt die maximale Anzahl von Rollennamen an, die im Rollencookie zwischengespeichert werden können. Der Standardwert ist 25. |
Geerbte Attribute |
Optionale Attribute. Attribute, die von allen section-Elementen geerbt werden. Weitere Informationen finden Sie unter Von Abschnittselementen geerbte allgemeine Attribute. |
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
providers |
Optionales Element. Definiert eine Auflistung der Rollenanbieter für die Rollenverwaltung. |
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
system.web |
Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an. |
Hinweise
Das roleManager-Element konfiguriert eine Anwendung für die Rollenverwaltung.
Informationen darüber, wie Sie im Anwendungscode auf Konfigurationswerte für das roleManager-Element zugreifen und diese ändern können, finden Sie unter RoleManagerSection.
Standardkonfiguration
Das folgende roleManager-Standardelement wird nicht explizit in der Datei Machine.config oder der Stammdatei Web.config konfiguriert. Es ist jedoch die Standardkonfiguration, die von der Anwendung zurückgegeben wird. Die Anbieter werden explizit in der Datei Machine.config konfiguriert.
<roleManager
enabled="false"
cacheRolesInCookie="false"
cookieName=".ASPXROLES"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="All"
defaultProvider="AspNetSqlRoleProvider"
createPersistentCookie="false"
maxCachedResults="25">
<providers>
<clear />
<add
connectionStringName="LocalSqlServer"
applicationName="/"
name="AspNetSqlRoleProvider"
type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<add
applicationName="/"
name="AspNetWindowsTokenRoleProvider"
type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</providers>
</roleManager>
Beispiel
Das folgende Codebeispiel zeigt, wie eine ASP.NET-Anwendung so konfiguriert wird, dass sie die SqlRoleProvider-Klasse zum Speichern und Abrufen von Rolleninformationen verwendet.
<configuration>
<system.web>
<roleManager defaultProvider="SqlProvider"
enabled="true"
cacheRolesInCookie="true"
cookieName=".ASPROLES"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="All" >
<providers>
<add
name="SqlProvider"
type="System.Web.Security.SqlRoleProvider"
connectionStringName="SqlServices"
applicationName="SampleApplication" />
</providers>
</roleManager>
</system.web>
</configuration>
Elementinformationen
Konfigurationsabschnittshandler |
|
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene |
Anforderungen |
Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005 |
Siehe auch
Aufgaben
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Referenz
system.web-Element (ASP.NET-Einstellungsschema)
providers-Element für roleManager (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
Konzepte
Understanding ASP.NET Role Management
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen