Principal 類別

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v10.0.0-preview.1.25080.5

來源:

Principal.cs

封裝所有安全性主體共通的帳戶資料和作業。 這是所有安全性主體都衍生自的抽象基底類別。

C#

public abstract class Principal : IDisposable

繼承

Object

Principal

衍生

System.DirectoryServices.AccountManagement.AuthenticablePrincipal

System.DirectoryServices.AccountManagement.GroupPrincipal

實作

IDisposable

備註

衍生自這個類別的自定義擴充類別可以從衍生類別建構函式呼叫這個建構函式，以初始化基類。 如需詳細資訊，請參閱 主體延伸模組 概觀主題。

建構函式

Principal()

初始化 Principal 類別的新執行個體。 這個建構函式是由衍生的類別建構函式所呼叫，以初始化基底類別，而且不適合直接從您的程式碼呼叫。

屬性

Context	取得與主體關聯的主體內容。
ContextRaw	取得與這個主體關聯的主體內容。
ContextType	取得內容類型列舉值，這個值指定與這個主體建立關聯的主體內容類型。
Description	取得或設定主體的描述。
DisplayName	取得或設定這個主體的顯示名稱。
DistinguishedName	取得這個主體的辨別名稱 (DN)。
Guid	取得與這個主體關聯的 GUID。
Name	取得或設定這個主體的名稱。
SamAccountName	取得或設定這個主體的 SAM 帳戶名稱。
Sid	取得主體的安全識別項 (SID)。
StructuralObjectClass	取得結構性物件類別目錄屬性。
UserPrincipalName	取得或設定與此主體相關聯的使用者主體名稱 (UPN)。

方法

CheckDisposedOrDeleted()	判斷是否已在這個類別上呼叫 Dispose() 或 Delete() 方法。 這個方法是由衍生自此主體類別的類別呼叫。
Delete()	從存放區刪除主體物件。
Dispose()	處置 Principal 物件目前的執行個體。
Equals(Object)	傳回布林值，這個值指定提供的物件是否等於目前的物件。
ExtensionGet(String)	擷取擴充類別物件的屬性。
ExtensionSet(String, Object)	在擴充類別中設定屬性 (Attribute) 的值。
FindByIdentity(PrincipalContext, IdentityType, String)	傳回符合指定的識別類型和值的主體物件。 這一版的 FindByIdentity(PrincipalContext, IdentityType, String) 方法會判斷身分識別值的格式。
FindByIdentity(PrincipalContext, String)	傳回符合指定的識別值之主體物件。
FindByIdentityWithType(PrincipalContext, Type, IdentityType, String)	傳回符合指定的識別類型和值的主體物件。 這個方法會由衍生類別 FindByIdentity 方法的實作來呼叫，以將搜尋限制為衍生類別類型，而且不適合從您的程式碼中直接呼叫。
FindByIdentityWithType(PrincipalContext, Type, String)	傳回符合指定的識別類型和值的主體物件。 這個方法會由衍生類別 FindByIdentity 方法的實作來呼叫，以將搜尋限制為衍生類別類型，而且不適合從您的程式碼中直接呼叫。
GetGroups()	傳回群組物件的集合，指定目前的主體是哪些群組的成員。
GetGroups(PrincipalContext)	傳回群組物件的集合，這些群組物件代表的群組不但是主體所屬的群組，而且存在於指定之內容參數所提供的存放區內。
GetHashCode()	從主體物件的內容擷取建立的雜湊，適用於雜湊演算法和像是雜湊資料表的結構。
GetUnderlyingObject()	傳回能為主體物件提供連絡資料的基礎 DirectoryEntry 物件。
GetUnderlyingObjectType()	傳回基礎物件型別。
IsMemberOf(GroupPrincipal)	傳回布林值，這個值指定主體是否為所指定群組的成員。
IsMemberOf(PrincipalContext, IdentityType, String)	傳回布林值，這個值指定主體是否為識別型別和值所指定之群組的成員。
Save()	將在主體物件上所做的變更儲存至存放區。 如果這是新的主體物件，則這個方法會將其插入至存放區。
Save(PrincipalContext)	將在主體物件上所做的變更儲存至存放區。 如果這是新的主體物件，則這個方法會將其插入至指定的內容。 如果已保存主體，則會從原始內容移至指定的內容。
ToString()	傳回目前主體物件的使用者易記字串表示。

適用於