ClientRoleProvider Clase

  • Referencia

Definición

Espacio de nombres:
System.Web.ClientServices.Providers
Ensamblado:
System.Web.Extensions.dll

Obtiene información de roles para las aplicaciones basadas en Windows de un servicio de roles de 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
Herencia
Object
ProviderBase
RoleProvider
ClientRoleProvider

Ejemplos

En el código de ejemplo siguiente se muestra cómo usar esta propiedad para establecer mediante programación la ubicación del servicio de roles.

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

Comentarios

Puede usar los servicios de aplicación cliente para recuperar información de rol de un servicio de roles existente mediante la configuración de la aplicación para usar la ClientRoleProvider clase . Después de la configuración, puede determinar si un usuario autenticado está en un rol determinado llamando al IsInRole método del IPrincipal devuelto por la staticThread.CurrentPrincipal propiedad . Para las aplicaciones configuradas para usar servicios de aplicaciones cliente, esta propiedad devuelve ClientRolePrincipal. Dado que esta clase implementa la interfaz IPrincipal , no es necesario hacer referencia a esta explícitamente. El ClientRolePrincipal.IsInRole método llama internamente al ClientRoleProvider.IsUserInRole método .

La ClientRoleProvider clase es un proveedor de pertenencia a roles de solo lectura que recupera información de rol para los usuarios autenticados del servicio de roles indicado por la ServiceUri propiedad . El valor de la ServiceUri propiedad se recupera normalmente del archivo de configuración de la aplicación junto con otros valores de configuración.

Puede recuperar la instancia actual ClientRoleProvider a través de la staticRoles.Provider propiedad .

La ClientRoleProvider clase solo admite los GetRolesForUser métodos y IsUserInRole de la RoleProvider clase abstracta. Cuando se llama a uno de estos métodos para un usuario determinado, el proveedor de servicios comprueba primero la memoria caché de datos local para obtener información de rol. Si la memoria caché no contiene ninguna información de rol o la caché ha expirado, el proveedor de servicios recupera la información de rol del servicio de roles y la agrega a la memoria caché.

Puede especificar el período de tiempo de espera de la memoria caché de roles al configurar los servicios de aplicación cliente. Para forzar que el GetRolesForUser método recupere los datos de rol del servicio en lugar de la memoria caché local, llame primero al ResetCache método .

No puede usar la ClientRoleProvider clase para crear o eliminar roles, ni para modificar la pertenencia a roles de los usuarios. Para crear o modificar la información del rol, debe cambiar la configuración del servicio de rol en el servidor.

Constructores

ClientRoleProvider()

Inicializa una nueva instancia de la clase ClientRoleProvider.

Propiedades

ApplicationName

Esta propiedad no se usa en esta clase.
Description

Obtiene una descripción breve y fácil de comprender apropiada para mostrarla en las herramientas administrativas u otras interfaces de usuario.

(Heredado de ProviderBase)
Name

Obtiene el nombre descriptivo utilizado para hacer referencia al proveedor durante la configuración.

(Heredado de ProviderBase)
ServiceUri

Obtiene o establece el URI del servicio de roles.

Métodos

AddUsersToRoles(String[], String[])

Este método no se usa en esta clase.
CreateRole(String)

Este método no se usa en esta clase.
DeleteRole(String, Boolean)

Este método no se usa en esta clase.
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
FindUsersInRole(String, String)

Este método no se usa en esta clase.
GetAllRoles()

Este método no se usa en esta clase.
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetRolesForUser(String)

Obtiene los nombres de los roles a los que pertenece el usuario especificado.
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetUsersInRole(String)

Este método no se usa en esta clase.
Initialize(String, NameValueCollection)

Inicializa el proveedor.
IsUserInRole(String, String)

Obtiene un valor que indica si el usuario especificado está incluido en el rol especificado.
MemberwiseClone()

Crea una copia superficial del Object actual.

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

Este método no se usa en esta clase.
ResetCache()

Borra la información de roles almacenada en memoria caché y restablece el tiempo de espera de la caché.
RoleExists(String)

Este método no se usa en esta clase.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también