ClientRoleProvider Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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 static
Thread.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 static
Roles.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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour