roleManager-Element (ASP.NET-Einstellungsschema)

Artikel
08/10/2011

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. Der Standardwert 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. Der Standardwert 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.

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	RoleManagerSection
Konfigurationsmember	RoleManager
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

Freigeben über

roleManager-Element (ASP.NET-Einstellungsschema)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen