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 Windows-Authentifizierung als auch die WindowsTokenRoleProvider Klasse verwendet, um Rolleninformationen für Windows Benutzer abzurufen. Das authorization Element gibt an, dass nur Benutzer in der GRUPPE "BUILTIN\Administratoren" zugriff auf die Anwendung zulässig sind.

<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. Es ist am nützlichsten mit ASP.NET Anwendungen, die Windows-Authentifizierung Modus verwenden, in dem die IIS-Authentifizierungseinstellungen 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 Klasse nicht verwenden, um Rollen zu erstellen oder zu löschen oder die Mitgliedschaft einer Rolle zu ändern, die WindowsTokenRoleProvider auf Windows Gruppenmitgliedschaft basiert. Diese Funktionalität wird vom Windows Betriebssystem verwaltet. Die WindowsTokenRoleProvider Klasse unterstützt nur die und GetRolesForUser Methoden IsUserInRole 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)

Siehe auch

• Grundlegendes ASP.NET Rollenverwaltung