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 对象，并将该对象添加到集合的末尾。

注解

与 Remove 和 Contains一样，此函数有四个重载，但它们都执行相同的操作。 实现额外的重载只是为了提高可用性，以便使用 IntelliSense 的开发人员可以看到采用 UserPrincipal、 GroupPrincipal或 ComputerPrincipal 对象的重载。 调用任何一个用户、组或计算机重载与调用重 Principal 载完全等效。

Add(ComputerPrincipal)

Source:

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)

Source:

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)

Source:

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)

Source:

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)

Source:

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 是空字符串