ClientRoleProvider Classe

  • Référence

Définition

Espace de noms:
System.Web.ClientServices.Providers
Assembly:
System.Web.Extensions.dll

Obtient des informations de rôle pour les applications Windows à partir d’un service de rôles 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
Héritage
Object
ProviderBase
RoleProvider
ClientRoleProvider

Exemples

L’exemple de code suivant montre comment utiliser cette propriété pour définir par programmation l’emplacement du service de rôles.

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

Remarques

Vous pouvez utiliser les services d’application client pour récupérer des informations de rôle à partir d’un service de rôles existant en configurant votre application pour qu’elle utilise la ClientRoleProvider classe . Après la configuration, vous pouvez déterminer si un utilisateur authentifié se trouve dans un rôle particulier en appelant la IsInRole méthode du IPrincipal retourné par la staticThread.CurrentPrincipal propriété . Pour les applications configurées pour utiliser les services d'application cliente, cette propriété retourne un ClientRolePrincipal. Étant donné que cette classe implémente l'interface IPrincipal , vous n'avez pas besoin de la référencer explicitement. La ClientRolePrincipal.IsInRole méthode appelle la ClientRoleProvider.IsUserInRole méthode en interne.

La ClientRoleProvider classe est un fournisseur d’appartenance aux rôles en lecture seule qui récupère les informations de rôle pour les utilisateurs authentifiés à partir du service de rôles indiqué par la ServiceUri propriété . La valeur de la ServiceUri propriété est généralement récupérée à partir du fichier de configuration de l’application avec d’autres valeurs de configuration.

Vous pouvez récupérer l’instance actuelle ClientRoleProvider via la staticRoles.Provider propriété .

La ClientRoleProvider classe prend uniquement en charge les GetRolesForUser méthodes et IsUserInRole de la RoleProvider classe abstraite. Lorsque vous appelez l’une de ces méthodes pour un utilisateur particulier, le fournisseur de services vérifie d’abord les informations de rôle dans le cache de données local. Si le cache ne contient aucune information de rôle ou si le cache a expiré, le fournisseur de services récupère les informations de rôle du service de rôles et les ajoute au cache.

Vous pouvez spécifier le délai d’expiration du cache de rôles lorsque vous configurez les services d’application client. Pour forcer la GetRolesForUser méthode à récupérer les données de rôle du service au lieu du cache local, appelez d’abord la ResetCache méthode.

Vous ne pouvez pas utiliser la ClientRoleProvider classe pour créer ou supprimer des rôles, ou pour modifier l’appartenance aux rôles des utilisateurs. Pour créer ou modifier des informations de rôle, vous devez modifier la configuration du service de rôle sur le serveur.

Constructeurs

ClientRoleProvider()

Initialise une nouvelle instance de la classe ClientRoleProvider.

Propriétés

ApplicationName

Cette propriété n'est pas utilisée par cette classe.
Description

Obtient une description brève et conviviale qui peut s'afficher dans les outils d'administration ou d'autres interfaces utilisateur.

(Hérité de ProviderBase)
Name

Obtient le nom convivial qui référence le fournisseur au cours de la configuration.

(Hérité de ProviderBase)
ServiceUri

Obtient ou définit l'URI du service de rôle.

Méthodes

AddUsersToRoles(String[], String[])

Cette méthode n'est pas utilisée par cette classe.
CreateRole(String)

Cette méthode n'est pas utilisée par cette classe.
DeleteRole(String, Boolean)

Cette méthode n'est pas utilisée par cette classe.
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
FindUsersInRole(String, String)

Cette méthode n'est pas utilisée par cette classe.
GetAllRoles()

Cette méthode n'est pas utilisée par cette classe.
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetRolesForUser(String)

Obtient les noms des rôles auxquels l'utilisateur spécifié appartient.
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetUsersInRole(String)

Cette méthode n'est pas utilisée par cette classe.
Initialize(String, NameValueCollection)

Initialise le fournisseur.
IsUserInRole(String, String)

Obtient une valeur indiquant si l'utilisateur spécifié figure dans le rôle spécifié.
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
RemoveUsersFromRoles(String[], String[])

Cette méthode n'est pas utilisée par cette classe.
ResetCache()

Efface les informations de rôle mises en cache et réinitialise le délai d'attente du cache.
RoleExists(String)

Cette méthode n'est pas utilisée par cette classe.
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi