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

Artikel
09/03/2008

Aktualisiert: November 2007

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

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

<remove 
   name=" provider name" 
/>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
name	Erforderliches String-Attribut. Der Name der aus der Auflistung zu entfernenden Rollenanbieterinstanz. Dieses Attribut muss den gleichen Wert wie das name-Attribut des add-Elements haben, das zum Hinzufügen des Rollenanbieters zur Auflistung verwendet wurde.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das erforderliche Stammelement in 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.
providers	Definiert eine Auflistung der Rollenanbieter für die Rollenverwaltung.

Hinweise

Mithilfe des remove-Elements kann ein Verweis auf einen geerbten Anbieter aus der im providers-Element gespeicherten Auflistung der Rollenverwaltungsanbieter entfernt werden.

Das providers-Element definiert eine Auflistung von Rollenanbietern 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 in den Erläuterungen zur RoleManagerSection-Klasse.

Beispiel

Im folgenden Beispiel wird eine ASP.NET-Anwendung so konfiguriert, dass sie SqlRoleProvider zum Speichern und Abfragen von Rolleninformationen verwendet. Mithilfe des <remove>-Elements wird vor dem Hinzufügen der neuen SqlRoleProvider-Instanz die Standard-SQL-Serverrollenanbieterinstanz entfernt.

<configuration>
  <system.web>
      <roleManager defaultProvider="SqlProvider" 
                   enabled="true"
                   cacheRolesInCookie="true"
                   cookieName=".ASPROLES"
                   cookieTimeout="30"
                   cookiePath="/"
                   cookieRequireSSL="false"
                   cookieSlidingExpiration="true"
                   cookieProtection="All" >
        <providers>
        <remove name="AspNetSqlProvider" />
          <add
            name="SqlProvider"
            type="System.Web.Security.SqlRoleProvider"
            connectionStringName="SqlServices" 
            applicationName="SampleApplication" />
            
        </providers>
      </roleManager>
  </system.web>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler	RoleManagerSection
Konfigurationsmember	Providers
Konfigurierbare Verzeichnisse	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

Freigeben über

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