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

Artikel
05/27/2012

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

Fügt eine Rollenanbieterinstanz zur Auflistung der Rollenverwaltungsanbieter hinzu.

Dieses Element ist neu in .NET Framework, Version 2.0.

<add name="provider name" 
     type="string"
     connectionStringName="string"
     applicationName="string" 
     commandTimeout="number" 
     description="string" 
     cacheRefreshInterval="number" 
     scopeName="string"/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
applicationName	Optionales String-Attribut. Gibt den Anwendungsnamen an, unter dem Rollennamen in der Datenquelle gespeichert sind. Der Anwendungsname ermöglicht mehreren ASP.NET-Anwendungen die Nutzung derselben Datenbank, ohne auf doppelt vorhandene Rollennamen für unterschiedliche Anwendungen zu stoßen. Alternativ dazu können mehrere ASP.NET-Anwendungen dieselben Rolleninformationen durch Angabe desselben Anwendungsnamens verwenden. Die in .NET Framework enthaltenen Rollenanbieter verwenden den ApplicationVirtualPath-Eigenschaftswert für die ApplicationName-Eigenschaft, falls dieses Attribut nicht angegeben ist.
cacheRefreshInterval	Optionales Int32-Attribut. Gibt die Anzahl von Minuten zwischen erzwungenen Aktualisierungen der zwischengespeicherten Richtlinienspeicherdaten an und gilt nur für AuthorizationStoreRoleProvider. Der Standardwert ist 60.
commandTimeout	Optionales Int32-Attribut. Gibt die Anzahl der Sekunden an, nach denen ein an den Rollenmanager ausgegebener Befehl aufgrund der angegebenen Zeitbeschränkung abgebrochen wird. Dieses Timeout wird vom SQL-Anbieter beim Erstellen von SqlCommand-Objekten verwendet. Dieses Attribut ist in der ASP.NET-Konfiguration nicht standardmäßig festgelegt. Daher wird die ADO.NET-Standardeinstellung von 30 Sekunden verwendet. Wenn dieses Attribut festgelegt ist, verwendet der SQL-Anbieter den konfigurierten Timeoutwert für alle an die Datenbank ausgegebenen SQL-Befehle. Die Standardeinstellung ist 30 (ADO.NET-Standardeinstellung).
connectionStringName	Erforderliches String-Attribut. Gibt den Namen der im <connectionStrings>-Element definierten Verbindungszeichenfolge an. Die angegebene Verbindungszeichenfolge wird vom hinzugefügten Anbieter verwendet.
description	Optionales String-Attribut. Gibt eine Beschreibung der Rollenanbieterinstanz an.
name	Erforderliches String-Attribut. Legt den Namen der Anbieterinstanz fest. Dieser Wert wird für das defaultProvider-Attribut des <roleManager>-Elements verwendet, um die Anbieterinstanz als Standardrollenanbieter zu identifizieren. Zur Indizierung des Anbieters in der Providers-Auflistung wird auch der name des Anbieters verwendet.
scopeName	Optionales String-Attribut. Gibt den Sicherheitsbereich eines Richtlinienspeichers des Autorisierungs-Managers an, mit dem die Anbieterinstanz eine Verbindung herstellen soll, und gilt nur für AuthorizationStoreRoleProvider. Wenn scopeName angegeben ist, verwendet der Anbieter beim Verbinden mit dem Richtlinienspeicher die Kombination von applicationName und scopeName.
type	Erforderliches String-Attribut. Gibt den Typ an, der die abstrakte RoleProvider-Basisklasse implementiert.

Untergeordnete Elemente

Keine.

Ü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.
roleManager	Konfiguriert eine Anwendung für die Rollenverwaltung.
providers	Definiert eine Auflistung der Rollenanbieter für die Rollenverwaltung.

Hinweise

Das add-Element fügt der Auflistung von Rollenverwaltungsanbietern im providers-Element eine Rollenanbieterinstanz hinzu.

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 RoleManagerSection, WindowsTokenRoleProvider, SqlRoleProvider und AuthorizationStoreRoleProvider.

Standardkonfiguration

Das folgende providers-Standardelement ist in der Datei Machine.config 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

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	Add
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

add-Element für providers für roleManager (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