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

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Definiert eine Auflistung der Rollenanbieter für die Rollenverwaltung.

<providers>
   <add />
   <clear/>
   <remove />
</providers>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente für diesen Abschnitt beschrieben.

Attribute

Keine.

Untergeordnete Elemente

Element

Beschreibung

add

Optionales Element.

Fügt eine Rollenanbieterinstanz zur Auflistung der Rollenverwaltungsanbieter hinzu.

clear

Optionales Element.

Entfernt alle Verweise auf geerbte Rollenmanagementanbieter bis auf die vom aktuellen add-Element hinzugefügten.

remove

Optionales Element.

Entfernt einen Verweis auf einen geerbten Anbieter aus der Auflistung der Rollenverwaltungsanbieter.

Übergeordnete Elemente

Element

Beschreibung

configuration

Das erforderliche Stammelement jeder Konfigurationsdatei, 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.

roleManager

Konfiguriert eine Anwendung für die Rollenverwaltung.

Hinweise

Das providers-Element definiert eine Auflistung der Rollenanbieter 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 der RoleManagerSection-Klasse und unter folgenden Rollenanbietern: WindowsTokenRoleProvider, SqlRoleProvider.

Standardkonfiguration

Das folgende element-Standardelement wird in der Computerkonfigurationsdatei konfiguriert.

<roleManager>
   <providers>
      <add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
        <add name="AspNetWindowsTokenRoleProvider" applicationName="/" type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
   </providers>
</roleManager>

Beispiel

Im folgenden Beispiel wird eine ASP.NET-Anwendung so konfiguriert, dass sie die SqlRoleProvider-Klasse zum Speichern und Abfragen 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

Providers

Konfigurierbare Speicherorte

Machine.config

Web.config auf der Stammebene

Web.config auf der Anwendungsebene

Anforderungen

IIS 5.0, IIS 5.1 oder IIS 6.0

.NET Framework 2.0

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

roleManager-Element (ASP.NET-Einstellungsschema)

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

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

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

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

configuration-Element (allgemeines Einstellungsschema)

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

Konzepte

Understanding ASP.NET Role Management

Securing Configuration

Configuration Inheritance

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

ASP.NET-Referenz

Configuring ASP.NET Applications

ASP.NET Configuration API