Share via

ClientRoleProvider Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.ClientServices.Providers
Assembly:
System.Web.Extensions.dll

Ottiene informazioni sui ruoli per le applicazioni basate su Windows da un servizio ruolo 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
Ereditarietà
Object
ProviderBase
RoleProvider
ClientRoleProvider

Esempio

Il codice di esempio seguente illustra come usare questa proprietà per impostare a livello di codice il percorso del servizio ruoli.

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

Commenti

È possibile usare i servizi applicazione client per recuperare le informazioni sul ruolo da un servizio ruoli esistente configurando l'applicazione per l'uso della ClientRoleProvider classe. Dopo la configurazione, è possibile determinare se un utente autenticato si trova in un determinato ruolo chiamando il IsInRole metodo restituito IPrincipal dalla staticThread.CurrentPrincipal proprietà . Per le applicazioni configurate per l'uso dei servizi delle applicazioni client, questa proprietà restituisce un oggetto ClientRolePrincipal. Poiché questa classe implementa l'interfaccia IPrincipal , non è necessario farvi riferimento in modo esplicito. Il ClientRolePrincipal.IsInRole metodo chiama internamente il ClientRoleProvider.IsUserInRole metodo.

La ClientRoleProvider classe è un provider di appartenenza ai ruoli di sola lettura che recupera le informazioni sul ruolo per gli utenti autenticati dal servizio ruoli indicato dalla ServiceUri proprietà. Il valore della proprietà viene in genere recuperato dal file di configurazione dell'applicazione insieme ad altri valori di ServiceUri configurazione.

È possibile recuperare l'istanza corrente ClientRoleProvider tramite la staticRoles.Provider proprietà .

La ClientRoleProvider classe supporta solo i GetRolesForUser metodi e IsUserInRole della RoleProvider classe astratta. Quando si chiama uno di questi metodi per un determinato utente, il provider di servizi controlla prima la cache dei dati locale per informazioni sul ruolo. Se la cache non contiene informazioni sul ruolo o la cache è scaduta, il provider di servizi recupera le informazioni sul ruolo dal servizio ruoli e lo aggiunge alla cache.

È possibile specificare il periodo di timeout per la cache dei ruoli quando si configurano i servizi applicazioni client. Per forzare il GetRolesForUser metodo per recuperare i dati del ruolo dal servizio anziché dalla cache locale, chiamare prima il ResetCache metodo.

Non è possibile usare la classe per creare o eliminare ruoli o modificare l'appartenenza ClientRoleProvider al ruolo degli utenti. Per creare o modificare le informazioni sul ruolo, è necessario modificare la configurazione del servizio ruolo nel server.

Costruttori

ClientRoleProvider()

Inizializza una nuova istanza della classe ClientRoleProvider.

Proprietà

ApplicationName

Questa proprietà non viene usata da questa classe.
Description

Ottiene una breve descrizione di facile comprensione che è possibile visualizzare in strumenti di amministrazione o in altre interfacce utente (UI, User Interface).

(Ereditato da ProviderBase)
Name

Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione.

(Ereditato da ProviderBase)
ServiceUri

Ottiene o imposta l'URI del servizio ruolo.

Metodi

AddUsersToRoles(String[], String[])

Questo metodo non viene utilizzato da questa classe.
CreateRole(String)

Questo metodo non viene utilizzato da questa classe.
DeleteRole(String, Boolean)

Questo metodo non viene utilizzato da questa classe.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
FindUsersInRole(String, String)

Questo metodo non viene utilizzato da questa classe.
GetAllRoles()

Questo metodo non viene utilizzato da questa classe.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetRolesForUser(String)

Ottiene i nomi dei ruoli ai quali appartiene l'utente specificato.
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
GetUsersInRole(String)

Questo metodo non viene utilizzato da questa classe.
Initialize(String, NameValueCollection)

Inizializza il provider.
IsUserInRole(String, String)

Ottiene un valore che indica se l'utente specificato appartiene al ruolo specificato.
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
RemoveUsersFromRoles(String[], String[])

Questo metodo non viene utilizzato da questa classe.
ResetCache()

Cancella le informazioni sui ruoli memorizzate nella cache e reimposta il periodo di timeout della cache.
RoleExists(String)

Questo metodo non viene utilizzato da questa classe.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche