Propriedade My.User.Name

Artigo
08/25/2010

Obtém o nome do usuário atual.

' Usage
Dim value As String = My.User.Name
' Declaration
Public ReadOnly Property Name As String

Valor de retorno

Valor de propriedade

String.O nome do usuário corrente.

Comentários

Utilize o objeto My.User para obter informações sobre o usuário atual.

O principal que autentica o usuário também controla o formato do nome de usuário.Por padrão, um aplicativo usa a autenticação do Windows, e o nome de usuário tem o formato DOMÍNIO\nome_de_usuário.Uma implementação personalizada do principal não necessariamente usa o mesmo formato.

Observação:
O My.User.Name propriedade retornará uma seqüência de caracteres vazia quando executado no Windows 95 e Windows 98 porque esses sistemas operacionais não reconhecem nomes de usuário.

Observação:
O comportamento exato das My.User objeto depende do tipo de aplicativo e o sistema operacional no qual o aplicativo é executado. Para obter mais informações, consulte Objeto My.usuário.

Tarefas

A tabela seguinte lista exemplos de tarefas envolvendo a propriedade My.User.Name.

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 a propriedade My.User.Name.

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