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 для указанного параметра `identity`, используя указанный параметр `providerName`.
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 для указанного параметра identity, используя указанный параметр providerName.

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)

Параметры

Исключения

Комментарии

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

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

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

Дополнительные ресурсы