Partager via

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

La classe ClientRoleProvider est un fournisseur d’appartenance de rôle 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 propriété ServiceUri. La valeur de la propriété ServiceUri est généralement récupérée à partir du fichier de configuration de l’application, ainsi que d’autres valeurs de configuration.

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

La classe ClientRoleProvider prend uniquement en charge les méthodes GetRolesForUser et IsUserInRole de la classe abstraite RoleProvider. Lorsque vous appelez l’une de ces méthodes pour un utilisateur particulier, le fournisseur de services vérifie d’abord le cache de données local pour obtenir des informations de rôle. 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 l’ajoute au cache.

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

Vous ne pouvez pas utiliser la classe ClientRoleProvider 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 brève description conviviale adaptée à l’affichage dans les outils d’administration ou d’autres interfaces utilisateur (UIs).

(Hérité de ProviderBase)
Name

Obtient le nom convivial utilisé pour faire référence au fournisseur pendant 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()

Sert de fonction de hachage par défaut.

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

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

Obtient la 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é se trouve dans le rôle spécifié.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(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