Partilhar via


ClientRoleProvider Classe

Definição

Obtém informações de função para aplicativos baseados no 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
ClientRoleProvider

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 classe ClientRoleProvider. Após a configuração, você pode determinar se um usuário autenticado está em uma função específica chamando o método IsInRole do IPrincipal retornado pela propriedade staticThread.CurrentPrincipal. Para aplicativos configurados para usar serviços de aplicativo cliente, essa propriedade retorna um ClientRolePrincipal. Como essa classe implementa a interface IPrincipal, você não precisa referenciá-la explicitamente. O método ClientRolePrincipal.IsInRole chama internamente o método ClientRoleProvider.IsUserInRole.

A classe ClientRoleProvider é 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 propriedade ServiceUri. O valor da propriedade ServiceUri normalmente é recuperado do arquivo de configuração do aplicativo, juntamente com outros valores de configuração.

Você pode recuperar a instância ClientRoleProvider atual por meio da propriedade staticRoles.Provider.

A classe ClientRoleProvider dá suporte apenas aos métodos GetRolesForUser e IsUserInRole da classe abstrata RoleProvider. Quando você chama um desses métodos para um determinado usuário, 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 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 método GetRolesForUser a recuperar dados de função do serviço em vez do cache local, chame o método ResetCache primeiro.

Você não pode usar a classe ClientRoleProvider para criar ou excluir funções ou 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 descrição breve e amigável adequada para exibição em ferramentas administrativas ou em outras interfaces de usuário (UIs).

(Herdado de ProviderBase)
Name

Obtém o nome amigável usado para se referir 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[])

Esse método não é usado por essa classe.

CreateRole(String)

Esse método não é usado por essa classe.

DeleteRole(String, Boolean)

Esse método não é usado por essa classe.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FindUsersInRole(String, String)

Esse método não é usado por essa classe.

GetAllRoles()

Esse método não é usado por essa 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)

Esse método não é usado por essa 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.

MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
RemoveUsersFromRoles(String[], String[])

Esse método não é usado por essa classe.

ResetCache()

Limpa as informações de função armazenadas em cache e redefine o período de tempo limite do cache.

RoleExists(String)

Esse método não é usado por essa classe.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também