ClientRolePrincipal Classe

Definição

Espaço de Nomes:
System.Web.ClientServices
Assemblagem:
System.Web.Extensions.dll

Representa informação de segurança para serviços de aplicações do cliente, incluindo informações sobre funções.

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
Herança
Object
ClientRolePrincipal
Implementações
IPrincipal

Exemplos

O seguinte exemplo de código demonstra como usar esta classe para mostrar um botão apenas quando o utilizador está no papel de "gestor". Este exemplo requer um Button nome managerOnlyButton com valor inicial Visible de propriedade .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

Observações

Quando valida um utilizador nos serviços de aplicação cliente, o ClientFormsAuthenticationMembershipProvider ou define ClientWindowsAuthenticationMembershipProvider a staticThread.CurrentPrincipal propriedade para uma instância desta classe. Inicializa ClientFormsAuthenticationMembershipProvider a Identity propriedade para uma nova instância da ClientFormsIdentity classe. Inicializa ClientWindowsAuthenticationMembershipProvider a Identity propriedade do WindowsIdentity objeto devolvido pelo staticWindowsIdentity.GetCurrent() método.

Normalmente não acedes diretamente a esta aula. Normalmente, irá chamar o IsInRole método do IPrincipal retorno pela staticCurrentPrincipal propriedade. No entanto, pode converter o CurrentPrincipal valor da propriedade numa ClientRolePrincipal referência para chamar explicitamente o IsInRole método, como demonstrado na secção de Exemplo.

Construtores

Name Description
ClientRolePrincipal(IIdentity)

Inicializa uma nova instância da ClientRolePrincipal classe.

Propriedades

Name Description
Identity

Obtém a identidade de segurança associada ao ClientRolePrincipal.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsInRole(String)

Recebe um valor que indica se o utilizador representado por o ClientRolePrincipal está no papel especificado.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também