Objeto My.usuário

Artigo
08/25/2010

Fornece acesso a informações sobre o usuário corrente.

Comentários

As propriedades e métodos expostos pelo My.User objeto fornecem acesso a informações sobre o usuário corrente. O significado de "usuário corrente" difere ligeiramente entre aplicativos Windows e Web.Em um aplicativos do Windows, o usuário corrente é o usuário que executa o aplicativo.Em um aplicativo Web Web, o usuário corrente é o usuário que acessa o aplicativo Web.

The My.User propriedade também fornece acesso para o IPrincipal para o usuário corrente. Um objeto entidade de segurança de segurança representa o contexto de segurança do usuário, incluindo a identidade do usuário e funções aos quais o usuário pertence.

Para aplicativos Windows, essa propriedade oferece a mesma funcionalidade sistema autônomo a CurrentPrincipal propriedade. Para aplicativos da Web, essa propriedade oferece a mesma funcionalidade sistema autônomo a User propriedade do objeto retornado pela Current propriedade.

Observação:
Para aplicativos Windows, somente os projetos construído sobre o aplicativos do Windows inicializar de modelo a My.User objeto por padrão. Todos os outros tipos de projeto do Windows, você deve inicializar o My.User objeto chamando o Método My.usuário.InitializeWithWindowsUser explicitamente ou atribuindo um valor para CurrentPrincipal.

Observação:
O My.User objeto não pode relatar informações sobre o usuário corrente do Windows quando executado no Windows 95 e Windows 98 porque esses sistemas operacionais não oferecem suporte para o conceito de um usuário conectado. Você deve implementar autenticação personalizada para usar o My.User objeto nesses sistemas operacionais. Para obter mais informações, consulte Demonstra Passo a passo: Implementando autenticação Personalizar e autorização.

O My.User objeto não pode relatar informações sobre o usuário corrente do Windows quando executado no Windows 95 e Windows 98 porque esses sistemas operacionais não oferecem suporte para o conceito de um usuário conectado. Você deve implementar autenticação personalizada para usar o My.User objeto nesses sistemas operacionais. Para obter mais informações, consulte Demonstra Passo a passo: Implementando autenticação Personalizar e autorização.

Tarefas

A tabela seguinte lista exemplos de tarefas envolvendo o objeto My.User.

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
Determinar a função do usuário	Como: Determinar se um usuário está em um AAgruparar
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