User Classe

  • Referência

Definição

Namespace:
Microsoft.VisualBasic.ApplicationServices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

Fornece acesso às informações sobre o usuário atual.

public ref class User
public class User
type User = class
Public Class User
Herança
Object
User
Derivado

Exemplos

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

Comentários

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

A My.User propriedade também fornece acesso ao IPrincipal para o usuário atual. Um objeto principal representa o contexto de segurança do usuário, incluindo a identidade do usuário e quaisquer funções às quais o usuário pertence.

Para aplicativos do Windows, essa propriedade fornece a mesma funcionalidade que a CurrentPrincipal propriedade . Para aplicativos Web, essa propriedade fornece a mesma funcionalidade que a User propriedade do objeto retornado pela Current propriedade .

Observação

Para aplicativos do Windows, somente projetos criados no modelo de Aplicativo do Windows inicializam o My.User objeto por padrão. Em todos os outros tipos de projeto do Windows, você deve inicializar o My.User objeto chamando o InitializeWithWindowsUser método explicitamente ou atribuindo um valor a CurrentPrincipal.

Construtores

User()

Inicializa uma nova instância da classe User.

Propriedades

CurrentPrincipal

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

Obtém ou define o objeto de entidade de segurança que representa o usuário atual.
IsAuthenticated

Obtém um valor que indica se o usuário foi autenticado.
Name

Obtém o nome do usuário atual.

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)
InitializeWithWindowsUser()

Define e entidade de segurança atual do thread para o usuário do Windows que iniciou o aplicativo.
IsInRole(BuiltInRole)

Determina se o usuário atual pertence à função especificada.
IsInRole(String)

Determina se o usuário atual pertence à 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