User.CurrentPrincipal Propriedade

Definição

Namespace:

Microsoft.VisualBasic.ApplicationServices

Assembly:

Microsoft.VisualBasic.Forms.dll

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

public:
 property System::Security::Principal::IPrincipal ^ CurrentPrincipal { System::Security::Principal::IPrincipal ^ get(); void set(System::Security::Principal::IPrincipal ^ value); };

public System.Security.Principal.IPrincipal CurrentPrincipal { get; set; }

member this.CurrentPrincipal : System.Security.Principal.IPrincipal with get, set

Public Property CurrentPrincipal As IPrincipal

Valor da propriedade

IPrincipal

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

Exceções

SecurityException

O chamador não tem a permissão necessária para definir a entidade de segurança.

Exemplos

Este exemplo verifica se o aplicativo está usando o Windows ou a autenticação personalizada e usa essas informações para analisar My.User.Name a 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

Comentários

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

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

Este é um membro avançado; ele não é exibido no IntelliSense, a menos que você clique na guia Todos .

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo do Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controles da Web	Sim
Serviço do Windows	Sim
Site	Sim

Confira também

• IPrincipal
• Objetos (Visual Basic)