共用方式為


PrincipalCollection.Add 方法

定義

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

多載

Add(ComputerPrincipal)

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

Add(GroupPrincipal)

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

Add(Principal)

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

Add(UserPrincipal)

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

Add(PrincipalContext, IdentityType, String)

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

備註

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

Add(ComputerPrincipal)

來源:
PrincipalCollection.cs
來源:
PrincipalCollection.cs
來源:
PrincipalCollection.cs

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

public:
 void Add(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);
public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit
Public Sub Add (computer As ComputerPrincipal)

參數

屬性

備註

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

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

適用於

Add(GroupPrincipal)

來源:
PrincipalCollection.cs
來源:
PrincipalCollection.cs
來源:
PrincipalCollection.cs

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

public:
 void Add(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);
public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);
member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit
Public Sub Add (group As GroupPrincipal)

參數

屬性

備註

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

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

適用於

Add(Principal)

來源:
PrincipalCollection.cs
來源:
PrincipalCollection.cs
來源:
PrincipalCollection.cs

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

public:
 virtual void Add(System::DirectoryServices::AccountManagement::Principal ^ principal);
public void Add (System.DirectoryServices.AccountManagement.Principal principal);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.Principal principal);
abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit
[<System.Security.SecurityCritical>]
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 物件。

實作

屬性

備註

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

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

適用於

Add(UserPrincipal)

來源:
PrincipalCollection.cs
來源:
PrincipalCollection.cs
來源:
PrincipalCollection.cs

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

public:
 void Add(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);
public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);
member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit
[<System.Security.SecurityCritical>]
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
來源:
PrincipalCollection.cs
來源:
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);
[System.Security.SecurityCritical]
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
[<System.Security.SecurityCritical>]
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 為空字串

適用於