User Classe

Referência

Definição

Namespace:: Microsoft.VisualBasic.ApplicationServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Microsoft.VisualBasic.ApplicationServices.WebUser

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

Partilhar via