ClientRolePrincipal Classe

  • Référence

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.

public ref class ClientRolePrincipal : System::Security::Principal::IPrincipal
public class ClientRolePrincipal : System.Security.Principal.IPrincipal
type ClientRolePrincipal = class
    interface IPrincipal
Public Class ClientRolePrincipal
Implements 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.

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);
    }
}

Private Sub DisplayButtonForManagerRole()

    Try

        Dim rolePrincipal As ClientRolePrincipal = TryCast( _
            System.Threading.Thread.CurrentPrincipal, ClientRolePrincipal)

        If rolePrincipal IsNot Nothing And _
            rolePrincipal.IsInRole("manager") Then

            managerOnlyButton.Visible = True

        End If

    Catch ex As System.Net.WebException

        MessageBox.Show("Unable to access the role service.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

End Sub

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