User Classe

Definição

Espaço de Nomes:
Microsoft.VisualBasic.ApplicationServices
Assemblagem:
Microsoft.VisualBasic.dll

Proporciona acesso à informação sobre o utilizador atual.

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

Exemplos

Este exemplo verifica se a aplicação está a usar autenticação Windows ou personalizada, e usa essa informação 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

Observações

As propriedades e métodos expostos pelo My.User objeto dão acesso à informação sobre o utilizador atual. O significado de "utilizador atual" difere ligeiramente entre aplicações Windows e Web. Numa aplicação Windows, o utilizador atual é o utilizador que executa a aplicação. Numa aplicação Web, o utilizador atual é o utilizador que acede à aplicação.

A My.User propriedade também oferece acesso IPrincipal ao utilizador atual. Um objeto principal representa o contexto de segurança do utilizador, incluindo a identidade desse utilizador e quaisquer funções a que este pertença.

Para aplicações Windows, esta propriedade oferece a mesma funcionalidade que a propriedade CurrentPrincipal. Para aplicações Web, esta propriedade fornece a mesma funcionalidade que a User propriedade do objeto devolvida pela Current propriedade.

Note

Para aplicações Windows, apenas os projetos construídos sobre o modelo Windows Application inicializam o objeto My.User por defeito. Em todos os outros tipos de projetos Windows, deve inicializar o objeto My.User chamando explicitamente o método InitializeWithWindowsUser ou atribuindo um valor a CurrentPrincipal.

Construtores

Name Description
User()

Inicializa uma nova instância da User classe.

Propriedades

Name Description
CurrentPrincipal

Obtém ou define o principal atual (para segurança baseada em funções).
InternalPrincipal

Obtém ou define o objeto principal que representa o utilizador atual.
IsAuthenticated

Recebe um valor que indica se o utilizador foi autenticado.
Name

Obtém o nome do utilizador atual.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeWithWindowsUser()

Define o princípio atual do thread para o utilizador do Windows que iniciou a aplicação.
IsInRole(BuiltInRole)

Determina se o utilizador atual pertence ao papel especificado.
IsInRole(String)

Determina se o utilizador atual pertence ao papel especificado.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também