PrincipalCollection.Add 方法

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

將指定的主體加入至集合結尾。

多載

Add(ComputerPrincipal)	將指定的 ComputerPrincipal 物件加入至集合的尾端。
Add(GroupPrincipal)	將指定的 GroupPrincipal 物件加入至集合的尾端。
Add(Principal)	將指定的 Principal 物件加入至集合的尾端。
Add(UserPrincipal)	將指定的 UserPrincipal 物件加入至集合的尾端。
Add(PrincipalContext, IdentityType, String)	搜尋符合參數的 Principal 物件，並將它加入至集合結尾。

備註

如同 和 RemoveContains，此函式有四個多載，但它們全都會執行相同的動作。 額外的多載只會實作以改善可用性，讓使用 IntelliSense 的開發人員會看到採用 UserPrincipal、 GroupPrincipal或 ComputerPrincipal 物件的多載。 呼叫任何一個使用者、群組或計算機多載，與呼叫多 Principal 載完全相同。

Add(ComputerPrincipal)

來源:

PrincipalCollection.cs

將指定的 ComputerPrincipal 物件加入至集合的尾端。

public:
 void Add(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);

public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit

Public Sub Add (computer As ComputerPrincipal)

參數

computer

ComputerPrincipal

ComputerPrincipal 物件。

備註

此函式可能會擲回下列例外狀況：

例外狀況	描述
PrincipalExistsException	computer已存在於集合中。

Add(GroupPrincipal)

來源:

PrincipalCollection.cs

將指定的 GroupPrincipal 物件加入至集合的尾端。

public:
 void Add(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);

public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);

member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit

Public Sub Add (group As GroupPrincipal)

參數

group

GroupPrincipal

ComputerPrincipal 物件。

備註

此函式可能會擲回下列例外狀況：

例外狀況	描述
PrincipalExistsException	group已存在於集合中。

Add(Principal)

來源:

PrincipalCollection.cs

將指定的 Principal 物件加入至集合的尾端。

public:
 virtual void Add(System::DirectoryServices::AccountManagement::Principal ^ principal);

public void Add (System.DirectoryServices.AccountManagement.Principal principal);

abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit

Public Sub Add (principal As Principal)

參數

principal

Principal

Principal 物件。

實作

Add(T)

備註

此函式可能會擲回下列例外狀況：

例外狀況	描述
PrincipalExistsException	principal已存在於集合中。

Add(UserPrincipal)

來源:

PrincipalCollection.cs

將指定的 UserPrincipal 物件加入至集合的尾端。

public:
 void Add(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);

public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);

member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit

Public Sub Add (user As UserPrincipal)

參數

user

UserPrincipal

UserPrincipal 物件。

備註

此函式可能會擲回下列例外狀況：

例外狀況	描述
PrincipalExistsException	user已存在於集合中。

Add(PrincipalContext, IdentityType, String)

來源:

PrincipalCollection.cs

搜尋符合參數的 Principal 物件，並將它加入至集合結尾。

public:
 void Add(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public void Add (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

member this.Add : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> unit

Public Sub Add (context As PrincipalContext, identityType As IdentityType, identityValue As String)

參數

context

PrincipalContext

要加入至集合中之主體的 PrincipalContext 物件。

identityType

IdentityType

IdentityType物件，指定的格式identityValue。

identityValue

String

識別主體的字串，格式為 所 identityType指定的 。

備註

此函式可能會擲回下列例外狀況：

例外狀況	描述
PrincipalExistsException	符合這些參數的主體已存在於集合中。
NoMatchingPrincipalException	找不到符合指定參數的主體。
MultipleMatchesException	多個主體符合指定的參數。
ArgumentException	identityType 為空字串