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

Определение

Пространство имен:: System.Web.Security

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Создает новый экземпляр класса RolePrincipal.

Перегрузки

Имя	Описание
RolePrincipal(IIdentity)	RolePrincipal Создает экземпляр объекта для указанного `identity`объекта.
RolePrincipal(SerializationInfo, StreamingContext)	Инициализирует новый экземпляр RolePrincipal класса, используя сведения, содержащиеся в указанном SerializationInfo объекте, и с помощью указанного контекста потоковой передачи.
RolePrincipal(IIdentity, String)	RolePrincipal Создает экземпляр объекта для указанного объекта с сведениями о роли `identity` из указанного объекта`encryptedTicket`.
RolePrincipal(String, IIdentity)	RolePrincipal Создает экземпляр объекта для указанного с помощью указанного `identityproviderName`.
RolePrincipal(String, IIdentity, String)	RolePrincipal Создает экземпляр объекта для указанного, `identity` используя указанные `providerName` сведения и сведения о роли из указанного объекта`encryptedTicket`.

RolePrincipal(IIdentity)

RolePrincipal Создает экземпляр объекта для указанного identityобъекта.

public:
 RolePrincipal(System::Security::Principal::IIdentity ^ identity);

public RolePrincipal(System.Security.Principal.IIdentity identity);

new System.Web.Security.RolePrincipal : System.Security.Principal.IIdentity -> System.Web.Security.RolePrincipal

Public Sub New (identity As IIdentity)

Параметры

identity: IIdentity

Удостоверение пользователя, для создания RolePrincipal для.

Исключения

ArgumentNullException

identity равно null.

Примеры

В следующем примере кода создается новый RolePrincipal объект. Если CacheRolesInCookie это trueтак, в примере создается RolePrincipal информация о файлах cookie из файла cookie, определяемого свойством CookieName .

RolePrincipal r;

if (Roles.CacheRolesInCookie)
{
  string roleCookie = "";

  HttpCookie cookie = HttpContext.Current.Request.Cookies[Roles.CookieName];
  if (cookie != null) { roleCookie = cookie.Value; }

  r = new RolePrincipal(User.Identity, roleCookie);
}
else
{
  r = new RolePrincipal(User.Identity);
}

Dim r As RolePrincipal

If Roles.CacheRolesInCookie Then
  Dim roleCookie As String = ""

  Dim cookie As HttpCookie = HttpContext.Current.Request.Cookies(Roles.CookieName)
  If Not cookie Is Nothing Then roleCookie = cookie.Value

  r = New RolePrincipal(User.Identity, roleCookie)
Else
  r = new RolePrincipal(User.Identity)
End If

Эта перегрузка конструктора RolePrincipal создает новый RolePrincipal объект и инициализирует его значения свойств. Сведения о кэшированных ролях не считываются из файла cookie, определяемого свойством CookieName . Свойство ProviderName имеет Name значение поставщика ролей по умолчанию.

Сведения о включении управления ролями см. в Roles классе.

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

Управление авторизацией с помощью ролей ASP.NET

Применяется к

RolePrincipal(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр RolePrincipal класса, используя сведения, содержащиеся в указанном SerializationInfo объекте, и с помощью указанного контекста потоковой передачи.

protected:
 RolePrincipal(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

protected RolePrincipal(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

new System.Web.Security.RolePrincipal : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Web.Security.RolePrincipal

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Параметры

info: SerializationInfo

Объект SerializationInfo для заполнения данными.

context: StreamingContext

Назначение для этой сериализации.

Применяется к

RolePrincipal(IIdentity, String)

RolePrincipal Создает экземпляр объекта для указанного объекта с сведениями о роли identity из указанного объектаencryptedTicket.

public:
 RolePrincipal(System::Security::Principal::IIdentity ^ identity, System::String ^ encryptedTicket);

public RolePrincipal(System.Security.Principal.IIdentity identity, string encryptedTicket);

new System.Web.Security.RolePrincipal : System.Security.Principal.IIdentity * string -> System.Web.Security.RolePrincipal

Public Sub New (identity As IIdentity, encryptedTicket As String)

Параметры

identity: IIdentity

Удостоверение пользователя, для создания RolePrincipal для.

encryptedTicket: String

Строка, содержащая зашифрованные сведения о роли.

Исключения

ArgumentNullException

identity равно null.

–или–

encryptedTicket равно null.

Примеры

RolePrincipal r;

if (Roles.CacheRolesInCookie)
{
  string roleCookie = "";

  HttpCookie cookie = HttpContext.Current.Request.Cookies[Roles.CookieName];
  if (cookie != null) { roleCookie = cookie.Value; }

  r = new RolePrincipal(User.Identity, roleCookie);
}
else
{
  r = new RolePrincipal(User.Identity);
}

Dim r As RolePrincipal

If Roles.CacheRolesInCookie Then
  Dim roleCookie As String = ""

  Dim cookie As HttpCookie = HttpContext.Current.Request.Cookies(Roles.CookieName)
  If Not cookie Is Nothing Then roleCookie = cookie.Value

  r = New RolePrincipal(User.Identity, roleCookie)
Else
  r = new RolePrincipal(User.Identity)
End If

Использование экземпляра этого типа с ненадежными данными является угрозой безопасности. Используйте этот объект только с доверенными данными. Дополнительные сведения см. в разделе Проверка всех входных данных.

Эта перегрузка конструктора RolePrincipal создает новый RolePrincipal объект и инициализирует его значения свойств. Сведения о роли для текущего пользователя считываются из предоставленного encryptedTicket и кэшированного объекта RolePrincipal . Свойство ProviderName имеет Name значение поставщика ролей по умолчанию.

Сведения о включении управления ролями см. в Roles классе.

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

Управление авторизацией с помощью ролей ASP.NET

Применяется к

RolePrincipal(String, IIdentity)

RolePrincipal Создает экземпляр объекта для указанного с помощью указанного identityproviderName.

public:
 RolePrincipal(System::String ^ providerName, System::Security::Principal::IIdentity ^ identity);

public RolePrincipal(string providerName, System.Security.Principal.IIdentity identity);

new System.Web.Security.RolePrincipal : string * System.Security.Principal.IIdentity -> System.Web.Security.RolePrincipal

Public Sub New (providerName As String, identity As IIdentity)

Параметры

providerName: String

Имя поставщика ролей для пользователя.

identity: IIdentity

Удостоверение пользователя, для создания RolePrincipal для.

Исключения

ArgumentNullException

identity равно null.

ArgumentException

providerName равно null.

–или–

providerName относится к поставщику ролей, который не существует в конфигурации приложения.

Эта перегрузка конструктора RolePrincipal создает новый RolePrincipal объект и инициализирует его значения свойств. Для ProviderName свойства задано значение, указанное в параметре providerName .

Сведения о включении управления ролями см. в Roles классе.

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

Управление авторизацией с помощью ролей ASP.NET

Применяется к

RolePrincipal(String, IIdentity, String)

RolePrincipal Создает экземпляр объекта для указанного, identity используя указанные providerName сведения и сведения о роли из указанного объектаencryptedTicket.

public:
 RolePrincipal(System::String ^ providerName, System::Security::Principal::IIdentity ^ identity, System::String ^ encryptedTicket);

public RolePrincipal(string providerName, System.Security.Principal.IIdentity identity, string encryptedTicket);

new System.Web.Security.RolePrincipal : string * System.Security.Principal.IIdentity * string -> System.Web.Security.RolePrincipal

Public Sub New (providerName As String, identity As IIdentity, encryptedTicket As String)

Параметры

providerName: String

Имя поставщика ролей для пользователя.

identity: IIdentity

Удостоверение пользователя, для создания RolePrincipal для.

encryptedTicket: String

Строка, содержащая зашифрованные сведения о роли.

Исключения

ArgumentNullException

identity равно null.

–или–

encryptedTicket равно null.

ArgumentException

providerName равно null.

–или–

providerName относится к поставщику ролей, который не существует в конфигурации приложения.

Эта перегрузка конструктора RolePrincipal создает новый RolePrincipal объект и инициализирует его значения свойств. Сведения о роли для текущего пользователя считываются из предоставленного encryptedTicket и кэшированного объекта RolePrincipal . Для ProviderName свойства задано значение, указанное в параметре providerName .

Сведения о включении управления ролями см. в Roles классе.

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

Управление авторизацией с помощью ролей ASP.NET

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через

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

Определение

Перегрузки

RolePrincipal(IIdentity)

Параметры

Исключения

Примеры

Комментарии

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

Применяется к

RolePrincipal(SerializationInfo, StreamingContext)

Параметры

Применяется к

RolePrincipal(IIdentity, String)

Параметры

Исключения

Примеры

Комментарии

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

Применяется к

RolePrincipal(String, IIdentity)

Параметры

Исключения

Комментарии

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

Применяется к

RolePrincipal(String, IIdentity, String)

Параметры

Исключения

Комментарии

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

Применяется к