WindowsTokenRoleProvider Klasa

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Pobiera informacje o roli aplikacji ASP.NET z członkostwa w grupie systemu Windows.

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

Dziedziczenie

Object

ProviderBase

RoleProvider

WindowsTokenRoleProvider

Przykłady

W poniższym przykładzie przedstawiono plik Web.config dla aplikacji ASP.NET. Określa, że aplikacja używa zarówno uwierzytelniania systemu Windows, jak i klasy do pobierania WindowsTokenRoleProvider informacji o roli dla użytkowników systemu Windows. Element authorization określa, że tylko użytkownicy w grupie BUILTIN\Administratorzy mogą uzyskiwać dostęp do aplikacji.

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

Uwagi

Klasa WindowsTokenRoleProvider jest dostawcą członkostwa w rolach tylko do odczytu, który pobiera informacje o roli użytkownika systemu Windows na podstawie grup zabezpieczeń systemu Windows. Jest to najbardziej przydatne w przypadku aplikacji ASP.NET korzystających z trybu uwierzytelniania systemu Windows, w którym ustawienia uwierzytelniania usług IIS wyłączają uwierzytelnianie anonimowe. Aplikacje ASP.NET można skonfigurować tak, aby zezwalały na dostęp lub odmawiały dostępu na podstawie członkostwa użytkownika w określonej grupie systemu Windows.

Nie można użyć WindowsTokenRoleProvider klasy do tworzenia lub usuwania ról ani modyfikowania członkostwa roli opartej na członkostwie w grupie systemu Windows. Ta funkcja jest zarządzana przez system operacyjny Windows. Klasa WindowsTokenRoleProvider obsługuje tylko IsUserInRole metody i GetRolesForUser klasy abstrakcyjnej RoleProvider .

Konstruktory

WindowsTokenRoleProvider()

Tworzy wystąpienie klasy WindowsTokenRoleProvider.

Właściwości

ApplicationName	Pobiera lub ustawia nazwę aplikacji.
Description	Pobiera krótki, przyjazny opis odpowiedni do wyświetlania w narzędziach administracyjnych lub innych interfejsach użytkownika (UI). (Odziedziczone po ProviderBase)
Name	Pobiera przyjazną nazwę używaną do odwoływania się do dostawcy podczas konfiguracji. (Odziedziczone po ProviderBase)

Metody

AddUsersToRoles(String[], String[])	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu systemu Windows.
CreateRole(String)	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu systemu Windows.
DeleteRole(String, Boolean)	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu systemu Windows.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindUsersInRole(String, String)	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu systemu Windows.
GetAllRoles()	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu systemu Windows.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetRolesForUser(String)	Pobiera listę grup systemu Windows, w których znajduje się użytkownik.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetUsersInRole(String)	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu systemu Windows.
Initialize(String, NameValueCollection)	Inicjuje dostawcę roli tokenu systemu Windows z wartościami właściwości określonymi w pliku konfiguracji aplikacji ASP.NET. Ta metoda nie jest przeznaczona do użycia bezpośrednio z kodu.
IsUserInRole(String, String)	Pobiera wartość wskazującą, czy określony użytkownik znajduje się w określonej grupie systemu Windows.
IsUserInRole(String, WindowsBuiltInRole)	Pobiera wartość wskazującą, czy określony użytkownik znajduje się w określonej wbudowanej roli systemu Windows.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
RemoveUsersFromRoles(String[], String[])	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu systemu Windows.
RoleExists(String)	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu systemu Windows.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Omówienie zarządzania rolami ASP.NET