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 est dans le rôle « manager ». Cet exemple nécessite un Button nommé managerOnlyButton avec une valeur de propriété initiale Visible 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 client, le ClientFormsAuthenticationMembershipProvider ou ClientWindowsAuthenticationMembershipProvider définit la staticThread.CurrentPrincipal propriété sur une instance de cette classe. ClientFormsAuthenticationMembershipProvider initialise la Identity propriété dans une nouvelle instance de la ClientFormsIdentity classe . initialise ClientWindowsAuthenticationMembershipProvider la Identity propriété sur l’objet WindowsIdentity retourné par la staticWindowsIdentity.GetCurrent() méthode .

En règle générale, vous n’accéderez pas directement à cette classe. Normalement, vous appelez la IsInRole méthode du IPrincipal retourné par la staticCurrentPrincipal propriété . Toutefois, vous pouvez convertir la valeur de la CurrentPrincipal propriété en référence ClientRolePrincipal pour appeler explicitement la IsInRole méthode, 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()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

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

Obtient une valeur indiquant si l'utilisateur représenté par le ClientRolePrincipal figure dans le rôle spécifié.
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi