RolePrincipal 類別

定義

命名空間:

System.Web.Security

組件:

System.Web.dll

表示目前 HTTP 要求的安全性資訊，包括角色成員資格。 此類別無法獲得繼承。

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

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

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

Public Class RolePrincipal
Inherits ClaimsPrincipal
Implements ISerializable

繼承

Object

ClaimsPrincipal

RolePrincipal

屬性

SerializableAttribute

實作

ISerializable

備註

對象 RolePrincipal 會實作 IPrincipal 介面，並代表 HTTP 要求的目前安全性內容。

當啟用角色管理 () Roles 時，會將 RoleManagerModule 物件指派 RolePrincipal 給 User 的 CurrentHttpContext屬性。

類別 RolePrincipal 會公開目前 HTTP 要求的安全性身分識別，並額外執行角色成員資格的檢查。 如果 CacheRolesInCookie 為 true，則 RolePrincipal 物件會管理角色的快取清單，並先在快取清單中查閱目前使用者的角色成員資格，然後再查詢角色 Provider。 如果 為 CacheRolesInCookiefalse，物件 RolePrincipal 一律會使用角色提供者查閱角色成員資格。

對象會RolePrincipal根據 CookieProtectionValue來加密和解密所識別CookieName之 Cookie 中快取的角色資訊。

建構函式

RolePrincipal(IIdentity)	產生指定之 identity 的 RolePrincipal 物件。
RolePrincipal(IIdentity, String)	使用指定 identity 中的角色資訊，產生指定之 encryptedTicket 的 RolePrincipal 物件。
RolePrincipal(SerializationInfo, StreamingContext)	使用指定之 RolePrincipal 物件中包含的資訊，以及使用指定的資料流內容，初始化 SerializationInfo 類別的新執行個體。
RolePrincipal(String, IIdentity)	使用指定的 identity，產生指定之 providerName 的 RolePrincipal 物件。
RolePrincipal(String, IIdentity, String)	使用指定的 identity，以及來自指定 providerName 的角色資訊，產生指定之 encryptedTicket 的 RolePrincipal 物件。

屬性

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 角色管理授權