Свойство My.User.Name

Статья
11/05/2008

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

Получает имя текущего пользователя.

' Usage
Dim value As String = My.User.Name
' Declaration
Public ReadOnly Property Name As String

Возвращаемое значение

String. Имя текущего пользователя.

Заметки

Для получения сведений о текущем пользователе можно использовать объект My.User.

Участник, который проверяет подлинность пользователя, также определяет формат имени пользователя. По умолчанию приложение использует проверку подлинности Windows, и имя пользователя имеет формат DOMAIN\USERNAME. Пользовательская реализация участника не обязательно использует тот же формат.

Примечание.
Свойство My.User.Name возвращает пустую строку при запуске в Windows 95 и Windows 98, поскольку эти операционные системы не распознают имена пользователей.

Примечание.
Точное поведение объекта My.User зависит от типа приложения и операционной системы, в которой выполняется приложение. Дополнительные сведения см. в разделе Объект My.User.

Задачи

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

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

Требования

Пространство имен:Microsoft.VisualBasic.ApplicationServices

Класс:User, WebUser

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Да
Служба Windows	Да
Веб-узел	Да

Разрешения

Могут потребоваться следующие разрешения.

Разрешение	Описание
SecurityPermission	Описывает набор разрешений безопасности, примененных к коду. Связанное перечисление: ControlPrincipal.