WindowsTokenRoleProvider Klasse

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Ruft Rolleninformationen für eine ASP.NET Anwendung aus 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 klasse WindowsTokenRoleProvider verwendet, um Rolleninformationen für Windows Benutzer abzurufen. Das authorization Element gibt an, dass nur Benutzer in der Gruppe BUILTIN\Administrators Zugriff auf die Anwendung haben.

<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 klasse WindowsTokenRoleProvider ist ein schreibgeschützter Rollenmitgliedschaftsanbieter, der Rolleninformationen für einen Windows Benutzer basierend auf Windows Sicherheitsgruppen abruft. Es ist am nützlichsten für ASP.NET Anwendungen, die Windows-Authentifizierung Modus verwenden, in dem die IIS-Authentifizierungseinstellungen die anonyme Authentifizierung deaktivieren. Sie können ASP.NET Anwendungen so konfigurieren, dass der Zugriff basierend auf der Mitgliedschaft eines Benutzers in einer bestimmten Windows Gruppe zugelassen oder verweigert wird.

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

Konstruktoren

Name Beschreibung
WindowsTokenRoleProvider()

Erstellt eine Instanz der WindowsTokenRoleProvider-Klasse.

Eigenschaften

Name Beschreibung
ApplicationName

Dient zum Abrufen oder Festlegen des Namens der Anwendung.
Description

Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen (UIs) geeignet ist.

(Geerbt von ProviderBase)
Name

Ruft den Anzeigenamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen.

(Geerbt von ProviderBase)

Methoden

Name Beschreibung
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 dem aktuellen Objekt entspricht.

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

Dient als Standardhashfunktion.

(Geerbt von Object)
GetRolesForUser(String)

Ruft eine Liste der Windows Gruppen ab, in denen sich ein Benutzer befindet.
GetType()

Ruft die 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 für die ASP.NET Anwendung angegeben sind. Diese Methode soll nicht direkt aus Dem Code verwendet werden.
IsUserInRole(String, String)

Ruft einen Wert ab, der angibt, ob sich der angegebene Benutzer in der angegebenen Windows-Gruppe befindet.
IsUserInRole(String, WindowsBuiltInRole)

Ruft einen Wert ab, der angibt, ob sich der angegebene Benutzer in der angegebenen integrierten Windows-Rolle befindet.
MemberwiseClone()

Erstellt eine flache Kopie der 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)

Gilt für:

Weitere Informationen