RolePrincipal Класс

Определение

Пространство имен:

System.Web.Security

Сборка:

System.Web.dll

Представляет сведения о безопасности для текущего HTTP-запроса, включая членство в роли. Этот класс не наследуется.

public ref class RolePrincipal : System::Runtime::Serialization::ISerializable, System::Security::Principal::IPrincipal

public ref class RolePrincipal : System::Security::Claims::ClaimsPrincipal, System::Runtime::Serialization::ISerializable

[System.Serializable]
public class RolePrincipal : System.Runtime.Serialization.ISerializable, System.Security.Principal.IPrincipal

[System.Serializable]
public class RolePrincipal : System.Security.Claims.ClaimsPrincipal, System.Runtime.Serialization.ISerializable

[<System.Serializable>]
type RolePrincipal = class
    interface IPrincipal
    interface ISerializable

[<System.Serializable>]
type RolePrincipal = class
    inherit ClaimsPrincipal
    interface ISerializable

Public Class RolePrincipal
Implements IPrincipal, ISerializable

Public Class RolePrincipal
Inherits ClaimsPrincipal
Implements ISerializable

Наследование

Object

RolePrincipal

Наследование

Object

ClaimsPrincipal

RolePrincipal

Атрибуты

SerializableAttribute

Реализации

ISerializable IPrincipal

Комментарии

Объект RolePrincipal реализует IPrincipal интерфейс и представляет текущий контекст безопасности для HTTP-запроса.

Если управление ролями включено (см. Roles), класс назначает RolePrincipal объект свойству UserCurrentHttpContextRoleManagerModule объекта .

Класс RolePrincipal предоставляет удостоверение безопасности для текущего HTTP-запроса и дополнительно проверяет членство в роли. Если CacheRolesInCookie имеет значение true, то RolePrincipal объект управляет кэшируемым списком ролей и сначала ищет членство в роли для текущего пользователя в кэшированном списке, а затем — роль Provider. Если CacheRolesInCookie имеет значение false, RolePrincipal объект всегда ищет членство в роли с помощью поставщика ролей.

Объект RolePrincipal шифрует и расшифровывает сведения о роли, кэшированные в файле cookie, идентифицируемом CookieName на основе CookieProtectionValue.

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

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

Свойства

CachedListChanged	Возвращает значение, показывающее, кэширован ли список имен ролей с измененным объектом RolePrincipal.
Claims	Возвращает коллекцию, содержащую все утверждения из всех удостоверений, основанных на утверждениях, которые связаны с этим субъектом утверждений. (Унаследовано от ClaimsPrincipal)
CookiePath	Возвращает путь к файлу cookie с именами ролей.
CustomSerializationData	Содержит дополнительные данные, предоставленные производным типом. Обычно устанавливается при вызове WriteTo(BinaryWriter, Byte[]). (Унаследовано от ClaimsPrincipal)
Expired	Возвращает значение, определяющее, истек ли срок действия файла Cookie ролей.
ExpireDate	Возвращает дату и время истечения срока действия файла Cookie ролей.
Identities	Возвращает коллекцию, содержащую все удостоверения утверждений, связанные с этим субъектом утверждений. (Унаследовано от ClaimsPrincipal)
Identity	Возвращает идентификатор безопасности для текущего HTTP-запроса.
IsRoleListCached	Возвращает значение, показывающее, кэширован ли в файле cookie список ролей пользователя.
IssueDate	Возвращает дату и время, которые выдает файл Cookie для ролей.
ProviderName	Возвращает имя поставщика роли, который хранит и извлекает сведения о роли для пользователя.
Version	Возвращает номер версии файла Cookie ролей.

Методы

AddIdentities(IEnumerable<ClaimsIdentity>)	Добавляет указанные удостоверения, основанные на утверждениях, в этот субъект утверждений. (Унаследовано от ClaimsPrincipal)
AddIdentity(ClaimsIdentity)	Добавляет указанное удостоверение утверждения к этому участнику утверждений. (Унаследовано от ClaimsPrincipal)
Clone()	Возвращает копию этого экземпляра. (Унаследовано от ClaimsPrincipal)
CreateClaimsIdentity(BinaryReader)	Создает новое удостоверение, основанное на утверждениях. (Унаследовано от ClaimsPrincipal)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindAll(Predicate<Claim>)	Извлекает все утверждения, соответствующие указанного предикату. (Унаследовано от ClaimsPrincipal)
FindAll(String)	Извлекает все утверждения или утверждения, которые имеют заданный тип утверждения. (Унаследовано от ClaimsPrincipal)
FindFirst(Predicate<Claim>)	Извлекает первое утверждение, соответствующие указанному предикату. (Унаследовано от ClaimsPrincipal)
FindFirst(String)	Извлекает первое утверждение с указанным типом утверждения. (Унаследовано от ClaimsPrincipal)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	Заполняет объект SerializationInfo данными, необходимыми для сериализации целевого объекта, используя заданный потоковый контекст.
GetRoles()	Возвращает список ролей, элементом которых является RolePrincipal.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
HasClaim(Predicate<Claim>)	Определяет, содержат ли удостоверения, основанные на утверждениях и связанные с субъектом утверждений, утверждения, которые соответствуют указанному предикату. (Унаследовано от ClaimsPrincipal)
HasClaim(String, String)	Определяет, содержат ли удостоверения утверждений, связанные с субъектом утверждений, утверждения с указанным типом и значением. (Унаследовано от ClaimsPrincipal)
IsInRole(String)	Возвращает значение, позволяющее определить, может ли пользователь, представленный классом RolePrincipal, выполнять указанную роль.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
SetDirty()	Отмечает кэшированный список ролей как измененный.
ToEncryptedTicket()	Возвращает сведения о роли, кэшированные с помощью объекта RolePrincipal, в зависимости от свойства CookieProtectionValue.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
WriteTo(BinaryWriter)	Выполняет сериализацию с помощью BinaryWriter. (Унаследовано от ClaimsPrincipal)
WriteTo(BinaryWriter, Byte[])	Выполняет сериализацию с помощью BinaryWriter. (Унаследовано от ClaimsPrincipal)

Явные реализации интерфейса

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Описание этого члена см. в разделе GetObjectData(Object, SerializationInfo, StreamingContext).

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

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