Udostępnij za pośrednictwem

ClientRolePrincipal Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.ClientServices
Zestaw:
System.Web.Extensions.dll

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

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 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

Zobacz też