User Класс

Определение

Пространство имен:

Microsoft.VisualBasic.ApplicationServices

Сборка:

Microsoft.VisualBasic.Forms.dll

Исходный код:

User.vb

Предоставляет доступ к сведениям о текущем пользователе.

public ref class User

public class User

type User = class

Public Class User

Наследование

Object

User

Производный

Microsoft.VisualBasic.ApplicationServices.WebUser

Примеры

В этом примере проверяется, использует ли приложение Windows или пользовательскую проверку подлинности и использует ли эта информация для анализа 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

Комментарии

Свойства и методы, предоставляемые My.User объектом, предоставляют доступ к сведениям о текущем пользователе. Значение "текущего пользователя" немного отличается от Windows и веб-приложений. В приложении Windows текущий пользователь — это пользователь, который запускает приложение. В веб-приложении текущий пользователь является пользователем, который обращается к приложению.

Свойство My.User также предоставляет доступ к IPrincipal текущему пользователю. Основной объект представляет контекст безопасности пользователя, включая удостоверение пользователя и все роли, к которым принадлежит пользователь.

Для приложений Windows это свойство предоставляет те же функции, что CurrentPrincipal и свойство. Для веб-приложений это свойство предоставляет те же функции, что User и свойство объекта, возвращаемого свойством Current .

Замечание

Для приложений Windows только проекты, созданные на основе шаблона приложения Windows , инициализируют My.User объект по умолчанию. Во всех других типах проектов Windows необходимо инициализировать My.User объект путем явного InitializeWithWindowsUser вызова метода или назначения значения CurrentPrincipal.

Конструкторы

Имя	Описание
User()	Инициализирует новый экземпляр класса User.

Свойства

Имя	Описание
CurrentPrincipal	Возвращает или задает текущий субъект (для безопасности на основе ролей).
InternalPrincipal	Возвращает или задает основной объект, представляющий текущего пользователя.
IsAuthenticated	Возвращает значение, указывающее, прошел ли пользователь проверку подлинности.
Name	Возвращает имя текущего пользователя.

Методы

Имя	Описание
IsInRole(String)	Определяет, принадлежит ли текущий пользователь указанной роли.

См. также раздел

• IPrincipal
• CurrentPrincipal
• User
• Current
• Объекты (Visual Basic)