ClientRoleProvider Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém informações de função de aplicativos baseados em Windows de um serviço de funções do Microsoft Ajax.
public ref class ClientRoleProvider : System::Web::Security::RoleProvider
public class ClientRoleProvider : System.Web.Security.RoleProvider
type ClientRoleProvider = class
inherit RoleProvider
Public Class ClientRoleProvider
Inherits RoleProvider
- Herança
Exemplos
O código de exemplo a seguir demonstra como usar essa propriedade para definir programaticamente o local do serviço de funções.
private void SetRolesServiceLocation()
{
((ClientRoleProvider)System.Web.Security.Roles.Provider).ServiceUri =
"http://localhost:55555/AppServices/Role_JSON_AppService.axd";
}
Private Sub SetRolesServiceLocation()
CType(System.Web.Security.Roles.Provider, _
ClientRoleProvider).ServiceUri = _
"http://localhost:55555/AppServices/Role_JSON_AppService.axd"
End Sub
Comentários
Você pode usar os serviços de aplicativo cliente para recuperar informações de função de um serviço de funções existente configurando seu aplicativo para usar a ClientRoleProvider classe . Após a configuração, você pode determinar se um usuário autenticado está em uma função específica chamando o IsInRole método do IPrincipal retornado pela static
Thread.CurrentPrincipal propriedade . Para aplicativos configurados para usar serviços de aplicativos cliente, essa propriedade retorna um ClientRolePrincipal. Como essa classe implementa a interface IPrincipal, você não precisa referenciá-la explicitamente. O ClientRolePrincipal.IsInRole método chama internamente o ClientRoleProvider.IsUserInRole método .
A ClientRoleProvider classe é um provedor de associação de função somente leitura que recupera informações de função para usuários autenticados do serviço de funções indicado pela ServiceUri propriedade . O valor da ServiceUri propriedade normalmente é recuperado do arquivo de configuração do aplicativo junto com outros valores de configuração.
Você pode recuperar a instância atual ClientRoleProvider por meio da static
Roles.Provider propriedade .
A ClientRoleProvider classe dá suporte apenas aos GetRolesForUser métodos e IsUserInRole da RoleProvider classe abstrata. Quando você chama um desses métodos para um usuário específico, o provedor de serviços primeiro verifica o cache de dados local em busca de informações de função. Se o cache não contiver nenhuma informação de função ou se o cache tiver expirado, o provedor de serviços recuperará as informações de função do serviço de funções e as adicionará ao cache.
Você pode especificar o período de tempo limite para o cache de funções ao configurar os serviços de aplicativo cliente. Para forçar o GetRolesForUser método a recuperar dados de função do serviço em vez do cache local, chame o ResetCache método primeiro.
Você não pode usar a ClientRoleProvider classe para criar ou excluir funções ou para modificar a associação de função dos usuários. Para criar ou modificar informações de função, você deve alterar a configuração do serviço de função no servidor.
Construtores
ClientRoleProvider() |
Inicializa uma nova instância da classe ClientRoleProvider. |
Propriedades
ApplicationName |
Essa propriedade não é usada por essa classe. |
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) |
ServiceUri |
Obtém ou define o URI do serviço de função. |
Métodos
AddUsersToRoles(String[], String[]) |
Este método não é usado por esta classe. |
CreateRole(String) |
Este método não é usado por esta classe. |
DeleteRole(String, Boolean) |
Este método não é usado por esta classe. |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
FindUsersInRole(String, String) |
Este método não é usado por esta classe. |
GetAllRoles() |
Este método não é usado por esta classe. |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetRolesForUser(String) |
Obtém os nomes das funções às quais o usuário especificado pertence. |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
GetUsersInRole(String) |
Este método não é usado por esta classe. |
Initialize(String, NameValueCollection) |
Inicializa o provedor. |
IsUserInRole(String, String) |
Obtém um valor que indica se o usuário especificado está na função especificada para a função especificada. |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
RemoveUsersFromRoles(String[], String[]) |
Este método não é usado por esta classe. |
ResetCache() |
Limpa as informações de função em cache e redefine o período de tempo limite de cache. |
RoleExists(String) |
Este método não é usado por esta classe. |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de