clear-Element für providers 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.]
Entfernt alle Verweise auf geerbte Rollenanbieter bis auf die vom aktuellen add-Element hinzugefügten.
Dieses Element ist neu in .NET Framework, Version 2.0.
<clear/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Keine.
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 clear-Element entfernt alle Verweise auf geerbte Rollenverwaltungsanbieter, die im providers-Element gespeichert sind, bis auf die von nachfolgenden add-Elementen hinzugefügten.
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.
Beispiel
Das folgende Codebeispiel zeigt, wie eine ASP.NET-Anwendung so konfiguriert wird, dass sie den SqlRoleProvider-Anbieter zum Speichern und Abrufen von Rolleninformationen verwendet. Das <clear>-Element löscht die RoleProviderCollection-Auflistung, bevor es den SqlRoleProvider hinzufügt.
<configuration>
<system.web>
<roleManager defaultProvider="SqlProvider"
enabled="true"
cacheRolesInCookie="true"
cookieName=".ASPROLES"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="All" >
<providers>
<clear />
<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
providers-Element für roleManager (ASP.NET-Einstellungsschema)
add-Element für providers für roleManager (ASP.NET-Einstellungsschema)
remove-Element für providers für roleManager (ASP.NET-Einstellungsschema)
roleManager-Element (ASP.NET-Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
Konzepte
Understanding ASP.NET Role Management
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen