remove-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 einen Verweis auf einen geerbten Anbieter aus der Auflistung der Rollenverwaltungsanbieter.

<remove 
   name=" provider name" 
/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und ü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 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 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 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 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

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

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

add-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)

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