My.usuário.CurrentPrincipal propriedade

Artigo
08/25/2010

Obtém ou define o objeto atual (para segurança baseada em função).

' Usage
Dim value As System.Security.Principal.IPrincipal = My.User.CurrentPrincipal
' Declaration
Public Property CurrentPrincipal As System.Security.Principal.IPrincipal

Valor de retorno

Valor de propriedade

A IPrincipal valor que representa o contexto de segurança.

Exceções

As condições a seguir podem causar uma exceção:

O chamador não tem a permissão necessária para conjunto o entidade de segurança de segurança (SecurityException).

Comentários

Você pode conjunto o My.User.CurrentPrincipal propriedade para um objeto que implementa o IPrincipal interface para habilitar a autenticação personalizada.

A maioria dos tipos de projeto, essa propriedade obtém e define o entidade de segurança de segurança corrente do segmento.Em um aplicativo ASP.NET, essa propriedade obtém e define as informações de segurança para identidade de usuário da solicitação HTTP corrente.

Este é um membro avançado; ele não exibe em IntelliSense a não ser que você clique na lingueta All.

Tarefas

Para	Consulte
Obter nome de login do usuário	Como: Determinar nome de logon do usuário
Obter nome de domínio do usuário, se o aplicativo usa autenticação do Windows	Como: Determinar o domínio do usuário
Implementar autenticação personalizada	Demonstra Passo a passo: Implementando autenticação Personalizar e autorização

Exemplo

Este exemplo verifica se o aplicativo usa autenticação Windows ou personalizada e usa essas informações para analisar My.User.Name propriedade.

Function GetUserName() As String
    If TypeOf My.User.CurrentPrincipal Is _
    Security.Principal.WindowsPrincipal Then
        ' The application is using Windows authentication.
        ' The name format is DOMAIN\USERNAME.
        Dim parts() As String = Split(My.User.Name, "\")
        Dim username As String = parts(1)
        Return username
    Else
        ' The application is using custom authentication.
        Return My.User.Name
    End If
End Function

Requisitos

Namespace:Microsoft.VisualBasic.ApplicationServices

Classe:User, WebUser

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim