Бөлісу құралы:


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

Определение

Создает новый экземпляр класса 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.

Исключения

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 . Свойству ProviderNameName присваивается значение поставщика ролей по умолчанию.

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

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

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

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

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

Исключения

identity имеет значение null.

-или-

encryptedTicket имеет значение 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 объект и инициализирует его значения свойств. Сведения о роли для текущего пользователя считываются из предоставленного encryptedTicket объекта и кэшируются вместе с RolePrincipal объектом . Свойству ProviderNameName присваивается значение поставщика ролей по умолчанию.

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

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

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

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.

Исключения

identity имеет значение null.

providerName имеет значение null.

-или-

Параметр providerName ссылается на поставщика роли, который не существует для приложения.

Комментарии

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

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

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

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

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

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

Исключения

identity имеет значение null.

-или-

encryptedTicket имеет значение null.

providerName имеет значение null.

-или-

Параметр providerName ссылается на поставщика роли, который не существует для приложения.

Комментарии

Важно!

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

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

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

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

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