ClientRolePrincipal Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.ClientServices
Assembly:
System.Web.Extensions.dll

Rappresenta informazioni sulla sicurezza per i servizi dell'applicazione client che includono informazioni sui ruoli.

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
Ereditarietà
Object
ClientRolePrincipal
Implementazioni
IPrincipal

Esempio

Il codice di esempio seguente illustra come usare questa classe per visualizzare un pulsante solo quando l'utente si trova nel ruolo "manager". Questo esempio richiede un Button oggetto denominato managerOnlyButton con un valore di proprietà iniziale Visible di 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

Commenti

Quando si convalida un utente nei servizi applicazione client, ClientFormsAuthenticationMembershipProvider o la ClientWindowsAuthenticationMembershipProvider static Thread.CurrentPrincipal proprietà imposta su un'istanza di questa classe. Inizializza ClientFormsAuthenticationMembershipProvider la Identity proprietà in una nuova istanza della ClientFormsIdentity classe. Inizializza ClientWindowsAuthenticationMembershipProvider la Identity proprietà all'oggetto WindowsIdentity restituito dal static WindowsIdentity.GetCurrent() metodo .

In genere non si accede direttamente a questa classe. In genere, si chiamerà il IsInRole metodo dell'oggetto IPrincipal static CurrentPrincipal restituito dalla proprietà . Tuttavia, è possibile eseguire il cast del valore della proprietà in un ClientRolePrincipal riferimento per chiamare in modo esplicito il CurrentPrincipal IsInRole metodo, come illustrato nella sezione Esempio.

Costruttori

ClientRolePrincipal(IIdentity)

Inizializza una nuova istanza della classe ClientRolePrincipal.

Proprietà

Identity

Ottiene l'identità di sicurezza associata all'oggetto ClientRolePrincipal.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
IsInRole(String)

Ottiene un valore che indica se l'utente rappresentato dall'oggetto ClientRolePrincipal appartiene al ruolo specificato.
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche