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

Artikel
09/03/2008

Aktualisiert: November 2007

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.

configuration-Element (allgemeines Einstellungsschema)
  system.web-Element (ASP.NET-Einstellungsschema)
    roleManager-Element (ASP.NET-Einstellungsschema)
      providers-Element für roleManager (ASP.NET-Einstellungsschema)
        clear-Element für providers für roleManager (ASP.NET-Einstellungsschema)

<clear/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie ü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	RoleManagerSection
Konfigurationsmember	Providers
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

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

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen