WindowsTokenRoleProvider Klasa

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Pobiera informacje o rolach dla aplikacji ASP.NET z członkostwa w grupie 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

Poniższy przykład przedstawia plik Web.config dla aplikacji ASP.NET. Określa, że aplikacja używa zarówno uwierzytelniania Windows, jak i WindowsTokenRoleProvider klasy do pobierania informacji o roli dla użytkowników Windows. Element authorization określa, że tylko użytkownicy w grupie BUILTIN\Administrators mają 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 rolach dla użytkownika Windows na podstawie Windows grup zabezpieczeń. Jest to najbardziej przydatne w przypadku aplikacji ASP.NET korzystających z trybu uwierzytelniania 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 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 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 Windows.
CreateRole(String)	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu Windows.
DeleteRole(String, Boolean)	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu 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 Windows.
GetAllRoles()	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu Windows.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetRolesForUser(String)	Pobiera listę grup Windows, w których znajduje się użytkownik.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetUsersInRole(String)	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu Windows.
Initialize(String, NameValueCollection)	Inicjuje dostawcę roli tokenu 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 należy do określonej grupy Windows.
IsUserInRole(String, WindowsBuiltInRole)	Pobiera wartość wskazującą, czy określony użytkownik znajduje się w określonej wbudowanej roli 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 Windows.
RoleExists(String)	Ta metoda nie jest obsługiwana przez dostawcę roli tokenu Windows.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Opis zarządzania rolami ASP.NET