WindowsTokenRoleProvider Klasse

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Ruft Rolleninformationen für eine ASP.NET-Anwendung von der Windows-Gruppenmitgliedschaft ab.

public ref class WindowsTokenRoleProvider : System::Web::Security::RoleProvider

public class WindowsTokenRoleProvider : System.Web.Security.RoleProvider

type WindowsTokenRoleProvider = class
    inherit RoleProvider

Public Class WindowsTokenRoleProvider
Inherits RoleProvider

Vererbung

Object

ProviderBase

RoleProvider

WindowsTokenRoleProvider

Beispiele

Das folgende Beispiel zeigt die Web.config-Datei für eine ASP.NET-Anwendung. Es gibt an, dass die Anwendung sowohl die Windows-Authentifizierung als auch die WindowsTokenRoleProvider -Klasse verwendet, um Rolleninformationen für Windows-Benutzer abzurufen. Das authorization -Element gibt an, dass nur Benutzern in der Gruppe BUILTIN\Administrators der Zugriff auf die Anwendung gewährt wird.

<configuration>
  <system.web>
    <authentication mode="Windows" />

    <authorization>
      <allow roles="BUILTIN\Administrators" />
      <deny users="*" />
    </authorization>

    <roleManager defaultProvider="WindowsProvider"
      enabled="true"
      cacheRolesInCookie="false">
      <providers>
        <add
          name="WindowsProvider"
          type="System.Web.Security.WindowsTokenRoleProvider" />
      </providers>
    </roleManager>

  </system.web>
</configuration>

Hinweise

Die WindowsTokenRoleProvider -Klasse ist ein schreibgeschützter Rollenmitgliedschaftsanbieter, der Rolleninformationen für einen Windows-Benutzer basierend auf Windows-Sicherheitsgruppen abruft. Dies ist am nützlichsten bei ASP.NET Anwendungen, die den Windows-Authentifizierungsmodus verwenden, bei dem die IIS-Authentifizierungseinstellungen die anonyme Authentifizierung deaktivieren. Sie können ASP.NET Anwendungen konfigurieren, um den Zugriff basierend auf der Mitgliedschaft eines Benutzers in einer bestimmten Windows-Gruppe zuzulassen oder zu verweigern.

Sie können die WindowsTokenRoleProvider -Klasse nicht verwenden, um Rollen zu erstellen oder zu löschen oder die Mitgliedschaft einer Rolle zu ändern, die auf der Windows-Gruppenmitgliedschaft basiert. Diese Funktionalität wird vom Windows-Betriebssystem verwaltet. Die WindowsTokenRoleProvider -Klasse unterstützt nur die IsUserInRole Methoden und GetRolesForUser der RoleProvider abstrakten Klasse.

Konstruktoren

WindowsTokenRoleProvider()

Erstellt eine Instanz der WindowsTokenRoleProvider-Klasse.

Eigenschaften

ApplicationName	Ruft den Namen der Anwendung ab oder legt diesen fest.
Description	Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen geeignet ist. (Geerbt von ProviderBase)
Name	Ruft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Geerbt von ProviderBase)

Methoden

AddUsersToRoles(String[], String[])	Diese Methode wird vom Windows-Tokenrollenanbieter nicht unterstützt.
CreateRole(String)	Diese Methode wird vom Windows-Tokenrollenanbieter nicht unterstützt.
DeleteRole(String, Boolean)	Diese Methode wird vom Windows-Tokenrollenanbieter nicht unterstützt.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindUsersInRole(String, String)	Diese Methode wird vom Windows-Tokenrollenanbieter nicht unterstützt.
GetAllRoles()	Diese Methode wird vom Windows-Tokenrollenanbieter nicht unterstützt.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetRolesForUser(String)	Ruft eine Liste der Windows-Gruppen ab, denen ein Benutzer angehört.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetUsersInRole(String)	Diese Methode wird vom Windows-Tokenrollenanbieter nicht unterstützt.
Initialize(String, NameValueCollection)	Initialisiert den Windows-Tokenrollenanbieter mit den Eigenschaftswerten, die in der Konfigurationsdatei der ASP.NET-Anwendung angegeben sind. Diese Methode ist nicht für die direkte Verwendung im Code vorgesehen.
IsUserInRole(String, String)	Ruft einen Wert ab, der angibt, ob der angegebene Benutzer der angegebenen Windows-Gruppe angehört.
IsUserInRole(String, WindowsBuiltInRole)	Ruft einen Wert ab, der angibt, ob der angegebene Benutzer die angegebene integrierte Windows-Rolle innehat.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RemoveUsersFromRoles(String[], String[])	Diese Methode wird vom Windows-Tokenrollenanbieter nicht unterstützt.
RoleExists(String)	Diese Methode wird vom Windows-Tokenrollenanbieter nicht unterstützt.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Grundlegendes zu ASP.NET Rollenverwaltung