Freigeben über


roleManager-Element (ASP.NET-Einstellungsschema)

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.

Ü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

Aufgaben

Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Referenz

system.web-Element (ASP.NET-Einstellungsschema)

providers-Element für roleManager (ASP.NET-Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

Konzepte

Grundlegende Informationen über die Rollenverwaltung

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

ASP.NET-Referenz

ASP.NET-Websiteverwaltung

ASP.NET-Konfigurations-API