ClientRolePrincipal Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.ClientServices

Zestaw:: System.Web.Extensions.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje informacje o zabezpieczeniach dla usług aplikacji klienckich, w tym informacje o rolach.

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

Dziedziczenie: Object
ClientRolePrincipal

Implementuje: IPrincipal

Przykłady

Poniższy przykładowy kod pokazuje, jak używać tej klasy do wyświetlania przycisku tylko wtedy, gdy użytkownik znajduje się w roli "menedżer". Ten przykład wymaga Button nazwy managerOnlyButton z początkową Visible wartością falsewłaściwości .

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

Uwagi

Podczas sprawdzania poprawności użytkownika w usługach ClientFormsAuthenticationMembershipProvider aplikacji klienckich właściwość lub ClientWindowsAuthenticationMembershipProvider ustawia staticThread.CurrentPrincipal właściwość na wystąpienie tej klasy. Właściwość ClientFormsAuthenticationMembershipProvider inicjuje Identity nowe wystąpienie ClientFormsIdentity klasy . Właściwość ClientWindowsAuthenticationMembershipProvider inicjuje Identity obiekt WindowsIdentity zwrócony przez metodę staticWindowsIdentity.GetCurrent() .

Zazwyczaj nie będziesz uzyskiwać bezpośredniego dostępu do tej klasy. Zwykle metoda zwracana przez właściwość jest wywoływana IsInRolestaticIPrincipal CurrentPrincipal. Można jednak rzutować CurrentPrincipal wartość właściwości na ClientRolePrincipal odwołanie, aby jawnie wywołać IsInRole metodę, jak pokazano w sekcji Przykład.

Konstruktory

ClientRolePrincipal(IIdentity)

Inicjuje nowe wystąpienie klasy ClientRolePrincipal.

Właściwości

Identity

Pobiera tożsamość zabezpieczeń skojarzona z elementem ClientRolePrincipal.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsInRole(String)	Pobiera wartość wskazującą, czy użytkownik reprezentowany przez element ClientRolePrincipal znajduje się w określonej roli.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy