ClientRolePrincipal Classe

Définition

Espace de noms:

System.Web.ClientServices

Assembly:

System.Web.Extensions.dll

Représente des informations de sécurité pour les services d’application cliente, qui incluent des informations de rôle.

C#

public class ClientRolePrincipal : System.Security.Principal.IPrincipal

Héritage

Object

ClientRolePrincipal

Implémente

IPrincipal

Exemples

L’exemple de code suivant montre comment utiliser cette classe pour afficher un bouton uniquement lorsque l’utilisateur se trouve dans le rôle « gestionnaire ». Cet exemple nécessite un Button nommé managerOnlyButton avec une valeur de propriété de Visible initiale de false.

C#

private void DisplayButtonForManagerRole()
{
    try
    {
        ClientRolePrincipal rolePrincipal =
            System.Threading.Thread.CurrentPrincipal 
            as ClientRolePrincipal;

        if (rolePrincipal != null && rolePrincipal.IsInRole("manager"))
        {
            managerOnlyButton.Visible = true;
        }
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the roles service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
}

Remarques

Lorsque vous validez un utilisateur dans les services d’application cliente, le ClientFormsAuthenticationMembershipProvider ou le ClientWindowsAuthenticationMembershipProvider définit la propriété staticThread.CurrentPrincipal sur une instance de cette classe. La ClientFormsAuthenticationMembershipProvider initialise la propriété Identity sur une nouvelle instance de la classe ClientFormsIdentity. La ClientWindowsAuthenticationMembershipProvider initialise la propriété Identity à l’objet WindowsIdentity retourné par la méthode staticWindowsIdentity.GetCurrent().

Vous n’accéderez généralement pas directement à cette classe. Normalement, vous appelez la méthode IsInRole de l'IPrincipal retournée par la propriété staticCurrentPrincipal. Toutefois, vous pouvez convertir la valeur de la propriété CurrentPrincipal en référence ClientRolePrincipal pour appeler explicitement la méthode IsInRole, comme illustré dans la section Exemple.

Constructeurs

ClientRolePrincipal(IIdentity)

Initialise une nouvelle instance de la classe ClientRolePrincipal.

Propriétés

Identity

Obtient l’identité de sécurité associée au ClientRolePrincipal.

Méthodes

Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IsInRole(String)	Obtient une valeur indiquant si l’utilisateur représenté par l'ClientRolePrincipal se trouve dans le rôle spécifié.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

S’applique à

Voir aussi

• ClientFormsAuthenticationMembershipProvider
• ClientWindowsAuthenticationMembershipProvider
• CurrentPrincipal
• Identity
• ClientFormsIdentity
• WindowsIdentity
• IPrincipal
• IsInRole(String)
• IsInRole(String)
• des services d’applications clientes