ClientRolePrincipal Classe

  • Referência

Definição

Namespace:
System.Web.ClientServices
Assembly:
System.Web.Extensions.dll

Representa informações de segurança para serviços do aplicativo cliente, as quais incluem informações de função.

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 código de exemplo a seguir demonstra como usar essa classe para exibir um botão somente quando o usuário estiver na função "gerente". Este exemplo requer um Button nomeado managerOnlyButton com um valor de propriedade inicial de .falseVisible

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

Comentários

Quando você valida um usuário nos serviços de aplicativo cliente, o ClientFormsAuthenticationMembershipProvider ou define ClientWindowsAuthenticationMembershipProvider a staticThread.CurrentPrincipal propriedade como uma instância dessa classe. O ClientFormsAuthenticationMembershipProvider inicializa a Identity propriedade para uma nova instância da ClientFormsIdentity classe . O ClientWindowsAuthenticationMembershipProvider inicializa a Identity propriedade para o WindowsIdentity objeto retornado pelo staticWindowsIdentity.GetCurrent() método .

Normalmente, você não acessará essa classe diretamente. Normalmente, você chamará o IsInRole método do IPrincipal retornado pela staticCurrentPrincipal propriedade . No entanto, você pode converter o valor da CurrentPrincipal propriedade em uma ClientRolePrincipal referência para chamar o IsInRole método explicitamente, conforme demonstrado na seção Exemplo.

Construtores

ClientRolePrincipal(IIdentity)

Inicializa uma nova instância da classe ClientRolePrincipal.

Propriedades

Identity

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

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsInRole(String)

Obtém um valor que indica se o usuário representado por ClientRolePrincipal está na função especificada.
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também