Объект My.User

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

Заметки

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

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

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

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

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

Примечание.
Объект My.User не содержит сведений о текущем пользователе Windows при запуске в Windows 95 и Windows 98, поскольку эти операционные системы не поддерживают концепцию вошедшего в систему пользователя. Необходимо реализовать нестандартную проверку подлинности для использования объекта My.User в этих операционных системах. Дополнительные сведения см. в разделе Пошаговое руководство. Реализация пользовательской проверки подлинности и авторизации.

Объект My.User не содержит сведений о текущем пользователе Windows при запуске в Windows 95 и Windows 98, поскольку эти операционные системы не поддерживают концепцию вошедшего в систему пользователя. Необходимо реализовать нестандартную проверку подлинности для использования объекта My.User в этих операционных системах. Дополнительные сведения см. в разделе Пошаговое руководство. Реализация пользовательской проверки подлинности и авторизации.

Задачи

В приведенной ниже таблице показаны примеры задач, включающих объект My.User.

To	см. раздел
Получение имени пользователя для входа в систему.	Практическое руководство. Определение имени, под которым пользователь вошел в систему
Получение имени домена пользователя, если приложение использует проверку подлинности Windows	Практическое руководство. Определение пользовательского домена
Определение роли пользователя	Практическое руководство. Определение принадлежности пользователя группе
Реализация пользовательской проверки подлинности	Пошаговое руководство. Реализация пользовательской проверки подлинности и авторизации

Пример

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