WindowsTokenRoleProvider Classe

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Obtém informações de função para um aplicativo ASP.NET da associação ao grupo do 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

Herança

Object

ProviderBase

RoleProvider

WindowsTokenRoleProvider

Exemplos

O exemplo a seguir mostra o arquivo de Web.config para um aplicativo ASP.NET. Ele especifica que o aplicativo usa a autenticação do Windows e a WindowsTokenRoleProvider classe para recuperar informações de função para usuários do Windows. O authorization elemento especifica que somente os usuários no grupo BUILTIN\Administrators têm permissão para acessar o aplicativo.

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

Comentários

A WindowsTokenRoleProvider classe é um provedor de associação de função somente leitura que recupera informações de função para um usuário do Windows com base em grupos de segurança do Windows. É mais útil com ASP.NET aplicativos que usam o modo de autenticação do Windows em que as configurações de autenticação do IIS desabilitam a autenticação anônima. Você pode configurar ASP.NET aplicativos para permitir ou negar o acesso com base na associação de um usuário em um determinado grupo do Windows.

Você não pode usar a WindowsTokenRoleProvider classe para criar ou excluir funções ou modificar a associação de uma função baseada na associação de grupo do Windows. Essa funcionalidade é gerenciada pelo sistema operacional Windows. A WindowsTokenRoleProvider classe dá suporte apenas aos IsUserInRole métodos e GetRolesForUser da RoleProvider classe abstrata.

Construtores

WindowsTokenRoleProvider()

Cria uma instância de WindowsTokenRoleProvider classe.

Propriedades

ApplicationName	Obtém ou define o nome do aplicativo.
Description	Obtém uma breve descrição amigável adequada para exibição em ferramentas administrativas ou outras IUs (interfaces do usuário). (Herdado de ProviderBase)
Name	Obtém o nome amigável usado para referir-se ao provedor durante a configuração. (Herdado de ProviderBase)

Métodos

AddUsersToRoles(String[], String[])	Este método não é compatível com o provedor de funções de token do Windows.
CreateRole(String)	Este método não é compatível com o provedor de funções de token do Windows.
DeleteRole(String, Boolean)	Este método não é compatível com o provedor de funções de token do Windows.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindUsersInRole(String, String)	Este método não é compatível com o provedor de funções de token do Windows.
GetAllRoles()	Este método não é compatível com o provedor de funções de token do Windows.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRolesForUser(String)	Obtém uma lista dos grupos do Windows de que um usuário faz parte.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUsersInRole(String)	Este método não é compatível com o provedor de funções de token do Windows.
Initialize(String, NameValueCollection)	Inicializa o provedor de funções de token do Windows com os valores de propriedade especificados no arquivo de configuração para o aplicativo ASP.NET. Esse método não se destina a ser usado diretamente do seu código.
IsUserInRole(String, String)	Obtém um valor que indica se o usuário especificado está no grupo do Windows especificado.
IsUserInRole(String, WindowsBuiltInRole)	Obtém um valor que indica se o usuário especificado está na função interna do Windows especificada.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
RemoveUsersFromRoles(String[], String[])	Este método não é compatível com o provedor de funções de token do Windows.
RoleExists(String)	Este método não é compatível com o provedor de funções de token do Windows.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Noções básicas sobre ASP.NET gerenciamento de funções