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

Статья
11/05/2008

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

Возвращает или задает текущего участника (для безопасности на основе ролей).

' Usage
Dim value As System.Security.Principal.IPrincipal = My.User.CurrentPrincipal
' Declaration
Public Property CurrentPrincipal As System.Security.Principal.IPrincipal

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

Значение IPrincipal, предоставляющее контекст безопасности.

Исключения

Исключение может возникнуть при следующих условиях:

Вызывающий оператор не имеет разрешения, которое требуется для определения основного участника (SecurityException).

Заметки

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

В большинстве типов проектов это свойство возвращает и задает текущего участника потока. В приложениях ASP.NET это свойство получает или задает сведения о безопасности для удостоверения пользователя текущего запроса HTTP.

Это дополнительный элемент. Он не отображается при использовании технологии IntelliSense, если вкладка Все не выбрана.

Задачи

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.