Classes de gestion des rôles

Article
10/22/2014

Mise à jour : novembre 2007

La gestion des rôles consiste en un jeu de classes et d'interfaces qui établissent des rôles pour l'utilisateur actuel et qui gèrent les informations relatives aux rôles. Le tableau suivant affiche les classes de gestion des rôles et les fonctions qu'elles fournissent.

Classe/interface	Fonctions
Roles Fournit des fonctionnalités de gestion générale pour les rôles.	Crée des rôles. Ajoute des utilisateurs aux rôles. Détermine si un utilisateur spécifique est dans un rôle. Reçoit des rôles pour les utilisateurs. Supprime des utilisateurs d'un rôle. Gère le cookie qui contient des informations de rôle. Remarque : Les fonctions permettant de créer des rôles et de leur assigner des utilisateurs ne fonctionnent pas si vous utilisez WindowsTokenRoleProvider. Dans ce cas, vous gérez les informations de rôle à l'aide de Windows.
RoleProvider Définit des fonctionnalités pour les fournisseurs de données qui peuvent être utilisées par les services de gestion des rôles.	Définit la fonctionnalité qu'un fournisseur doit implémenter pour être utilisé par la classe Roles.
RoleManagerModule Ajoute des informations de rôle à la propriété User actuelle.	Crée automatiquement un RolePrincipal et l'attache au contexte actuel. Déclenche un événement GetRoles qui vous permet de personnaliser le processus d'ajout de rôles au contexte d'utilisateur actuel.
RoleManagerEventArgs Définit les arguments passés à l'événement RoleManager_GetRoles.	Donne accès au contexte d'utilisateur actuel pendant l'événement GetRoles.
RolePrincipal Agit comme un objet IPrincipal et met en cache les rôles pour un utilisateur.	Stocke des informations de rôle pour l'utilisateur actuel. Gère la récupération d'informations de rôle à partir du cookie ou de la base de données (ou des deux, si nécessaire).
RoleService Fournit l'accès aux rôles en tant que service Windows Communication Framework.	Vérifie si un utilisateur appartient à un rôle spécifié. Récupère tous les rôles d'un utilisateur. Remarque : Les fonctionnalités générales de la gestion des rôles ne sont pas disponibles via la classe RoleService.

Roles

Fournit des fonctionnalités de gestion générale pour les rôles.

Crée des rôles.

Ajoute des utilisateurs aux rôles.

Détermine si un utilisateur spécifique est dans un rôle.

Reçoit des rôles pour les utilisateurs.

Supprime des utilisateurs d'un rôle.

Gère le cookie qui contient des informations de rôle.

Remarque :

Les fonctions permettant de créer des rôles et de leur assigner des utilisateurs ne fonctionnent pas si vous utilisez WindowsTokenRoleProvider. Dans ce cas, vous gérez les informations de rôle à l'aide de Windows.

RoleProvider

Définit des fonctionnalités pour les fournisseurs de données qui peuvent être utilisées par les services de gestion des rôles.

Définit la fonctionnalité qu'un fournisseur doit implémenter pour être utilisé par la classe Roles.

RoleManagerModule

Ajoute des informations de rôle à la propriété User actuelle.

Crée automatiquement un RolePrincipal et l'attache au contexte actuel.

Déclenche un événement GetRoles qui vous permet de personnaliser le processus d'ajout de rôles au contexte d'utilisateur actuel.

RoleManagerEventArgs

Définit les arguments passés à l'événement RoleManager_GetRoles.

Donne accès au contexte d'utilisateur actuel pendant l'événement GetRoles.

RolePrincipal

Agit comme un objet IPrincipal et met en cache les rôles pour un utilisateur.