ClientRolePrincipal Klasa

Definicja

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

public class ClientRolePrincipal : System.Security.Principal.IPrincipal
Dziedziczenie
ClientRolePrincipal
Implementuje

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 o nazwie managerOnlyButton z początkową wartością właściwości Visiblefalse.

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

Uwagi

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

Zazwyczaj nie będziesz uzyskiwać bezpośredniego dostępu do tej klasy. Zwykle wywołasz metodę IsInRoleIPrincipal zwróconą przez właściwość staticCurrentPrincipal. Można jednak rzutować wartość właściwości CurrentPrincipal na odwołanie ClientRolePrincipal w celu jawnego wywołania metody IsInRole, 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 ClientRolePrincipal.

Metody

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.

(Odziedziczone po Object)
IsInRole(String)

Pobiera wartość wskazującą, czy użytkownik reprezentowany przez ClientRolePrincipal znajduje się w określonej roli.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Produkt Wersje
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zobacz też