ClientRoleProvider Classe

  • Referência

Definição

Namespace:
System.Web.ClientServices.Providers
Assembly:
System.Web.Extensions.dll

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
Object
ProviderBase
RoleProvider
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 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 staticThread.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 staticRoles.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