Principal.Save 方法

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

將在主體物件上所做的變更儲存至存放區。 如果這是新的主體物件，則這個方法會將其插入至存放區。

多載

Save()	將在主體物件上所做的變更儲存至存放區。 如果這是新的主體物件，則這個方法會將其插入至存放區。
Save(PrincipalContext)	將在主體物件上所做的變更儲存至存放區。 如果這是新的主體物件，則這個方法會將其插入至指定的內容。 如果已保存主體，則會從原始內容移至指定的內容。

Save()

來源:

Principal.cs

將在主體物件上所做的變更儲存至存放區。 如果這是新的主體物件，則這個方法會將其插入至存放區。

public:
 void Save();

public void Save ();

member this.Save : unit -> unit

Public Sub Save ()

例外狀況

InvalidOperationException

主體尚未與 PrincipalContext 物件產生關聯。

這個型別的主體無法插入至存放區。

PrincipalOperationException

將變更儲存至存放區，或更新存放區中的群組成員資格時發生例外狀況。

PrincipalExistsException

主體已在存放區中。

PasswordException

密碼不符合複雜度要求。

Save(PrincipalContext)

來源:

Principal.cs

將在主體物件上所做的變更儲存至存放區。 如果這是新的主體物件，則這個方法會將其插入至指定的內容。 如果已保存主體，則會從原始內容移至指定的內容。

public:
 void Save(System::DirectoryServices::AccountManagement::PrincipalContext ^ context);

public void Save (System.DirectoryServices.AccountManagement.PrincipalContext context);

member this.Save : System.DirectoryServices.AccountManagement.PrincipalContext -> unit

Public Sub Save (context As PrincipalContext)

參數

context

PrincipalContext

針對執行的作業指定伺服器或網域的 PrincipalContext。

例外狀況

InvalidOperationException

主體尚未與 PrincipalContext 物件產生關聯。

這個型別的主體無法插入至存放區。

PrincipalOperationException

將變更儲存至存放區，或更新存放區中的群組成員資格時發生例外狀況。

PrincipalExistsException

主體已在存放區中。

PasswordException

密碼不符合複雜度要求。

備註

如果指定的主體內容與現有內容不同，則主體會移至指定的內容，而且主體物件不再位於舊位置。 如果指定的內容與現有內容相同，這個方法會將主體物件上所做的更新儲存至存放區。 指定之內容的內容型別必須與目前的內容型別相同。 此方法可能無法使用電腦內容類型來呼叫。