WindowsTokenRoleProvider Classe
Definição
Obtém informações de função para um aplicativo ASP.NET da associação ao grupo do Windows.Gets role information for an ASP.NET application from Windows group membership.
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
Exemplos
O exemplo a seguir mostra o arquivo de Web.config para um aplicativo ASP.NET.The following example shows the Web.config file for an ASP.NET application. 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.It specifies that the application uses both Windows authentication and the WindowsTokenRoleProvider class to retrieve role information for Windows users. O elemento Especifica que somente os usuários no grupo Builtin\administradores têm permissão de acesso ao aplicativo.The element specifies that only users in the BUILTIN\Administrators group are allowed access to the application.
<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 baseado em grupos de segurança do Windows.The WindowsTokenRoleProvider class is a read-only role-membership provider that retrieves role information for a Windows user based on Windows security groups. Ele é mais útil com aplicativos ASP.NET 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.It is most useful with ASP.NET applications that use Windows authentication mode where the IIS authentication settings disable anonymous authentication. Você pode configurar aplicativos ASP.NET para permitir ou negar o acesso com base na associação de um usuário em um determinado grupo do Windows.You can configure ASP.NET applications to allow or deny access based on a user's membership in a particular Windows group.
Você não pode usar a WindowsTokenRoleProvider classe para criar ou excluir funções ou modificar a associação de uma função com base na associação de grupo do Windows.You cannot use the WindowsTokenRoleProvider class to create or delete roles or modify the membership of a role that is based on Windows group membership. Essa funcionalidade é gerenciada pelo sistema operacional Windows.This functionality is managed by the Windows operating system. A WindowsTokenRoleProvider classe oferece suporte apenas IsUserInRole aos GetRolesForUser métodos e da RoleProvider classe abstrata.The WindowsTokenRoleProvider class supports only the IsUserInRole and GetRolesForUser methods of the RoleProvider abstract class.
Construtores
| WindowsTokenRoleProvider() |
Cria uma instância de WindowsTokenRoleProvider classe.Creates an instance of the WindowsTokenRoleProvider class. |
Propriedades
| ApplicationName |
Obtém ou define o nome do aplicativo.Gets or sets the name of the application. |
| Description |
Obtém uma breve descrição amigável adequada para exibição em ferramentas administrativas ou outras IUs (interfaces do usuário).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs). (Herdado de ProviderBase) |
| Name |
Obtém o nome amigável usado para referir-se ao provedor durante a configuração.Gets the friendly name used to refer to the provider during configuration. (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.This method is not supported by the Windows token role provider. |
| CreateRole(String) |
Este método não é compatível com o provedor de funções de token do Windows.This method is not supported by the Windows token role provider. |
| DeleteRole(String, Boolean) |
Este método não é compatível com o provedor de funções de token do Windows.This method is not supported by the Windows token role provider. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| FindUsersInRole(String, String) |
Este método não é compatível com o provedor de funções de token do Windows.This method is not supported by the Windows token role provider. |
| GetAllRoles() |
Este método não é compatível com o provedor de funções de token do Windows.This method is not supported by the Windows token role provider. |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetRolesForUser(String) |
Obtém uma lista dos grupos do Windows de que um usuário faz parte.Gets a list of the Windows groups that a user is in. |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| GetUsersInRole(String) |
Este método não é compatível com o provedor de funções de token do Windows.This method is not supported by the Windows token role provider. |
| 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.Initializes the Windows token role provider with the property values specified in the configuration file for the ASP.NET application. Esse método não se destina a ser usado diretamente do seu código.This method is not intended to be used directly from your code. |
| IsUserInRole(String, String) |
Obtém um valor que indica se o usuário especificado está no grupo do Windows especificado.Gets a value indicating whether the specified user is in the specified Windows group. |
| IsUserInRole(String, WindowsBuiltInRole) |
Obtém um valor que indica se o usuário especificado está na função interna do Windows especificada.Gets a value indicating whether the specified user is in the specified built-in Windows role. |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| RemoveUsersFromRoles(String[], String[]) |
Este método não é compatível com o provedor de funções de token do Windows.This method is not supported by the Windows token role provider. |
| RoleExists(String) |
Este método não é compatível com o provedor de funções de token do Windows.This method is not supported by the Windows token role provider. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (Herdado de Object) |