PrincipalCollection.Add Método

Definición

Espacio de nombres:

System.DirectoryServices.AccountManagement

Ensamblado:

System.DirectoryServices.AccountManagement.dll

Paquete:

System.DirectoryServices.AccountManagement v8.0.0

Agrega la entidad de seguridad especificada al final de la colección.

Sobrecargas

Add(ComputerPrincipal)	Agrega el objeto ComputerPrincipal especificado al final de la colección.
Add(GroupPrincipal)	Agrega el objeto GroupPrincipal especificado al final de la colección.
Add(Principal)	Agrega el objeto Principal especificado al final de la colección.
Add(UserPrincipal)	Agrega el objeto UserPrincipal especificado al final de la colección.
Add(PrincipalContext, IdentityType, String)	Busca un objeto Principal que cumpla los parámetros y lo agrega al final de la colección.

Comentarios

Al igual que con Remove y Contains, hay cuatro sobrecargas para esta función, pero todas hacen lo mismo. Las sobrecargas adicionales solo se implementan para mejorar la facilidad de uso, de modo que los desarrolladores que usan IntelliSense vean sobrecargas que toman un UserPrincipalobjeto , GroupPrincipalo ComputerPrincipal . Llamar a cualquiera de las sobrecargas de usuario, grupo o equipo es exactamente equivalente a llamar a la Principal sobrecarga.

Add(ComputerPrincipal)

Source:

PrincipalCollection.cs

Agrega el objeto ComputerPrincipal especificado al final de la colección.

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)

Parámetros

computer

ComputerPrincipal

Un objeto ComputerPrincipal.

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
PrincipalExistsException	computer ya existe en la colección.

Add(GroupPrincipal)

Source:

PrincipalCollection.cs

Agrega el objeto GroupPrincipal especificado al final de la colección.

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)

Parámetros

group

GroupPrincipal

Un objeto ComputerPrincipal.

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
PrincipalExistsException	group ya existe en la colección.

Add(Principal)

Source:

PrincipalCollection.cs

Agrega el objeto Principal especificado al final de la colección.

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)

Parámetros

principal

Principal

Un objeto Principal.

Implementaciones

Add(T)

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
PrincipalExistsException	principal ya existe en la colección.

Add(UserPrincipal)

Source:

PrincipalCollection.cs

Agrega el objeto UserPrincipal especificado al final de la colección.

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)

Parámetros

user

UserPrincipal

Un objeto UserPrincipal.

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
PrincipalExistsException	user ya existe en la colección.

Add(PrincipalContext, IdentityType, String)

Source:

PrincipalCollection.cs

Busca un objeto Principal que cumpla los parámetros y lo agrega al final de la colección.

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)

Parámetros

context

PrincipalContext

Objeto PrincipalContext de la entidad de seguridad que se va a agregar a la colección.

identityType

IdentityType

Objeto IdentityType que especifica el formato de identityValue.

identityValue

String

Cadena que identifica la entidad de seguridad, en el formato especificado por identityType.

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
PrincipalExistsException	La entidad de seguridad que coincide con estos parámetros ya existe en la colección.
NoMatchingPrincipalException	No se encontró ninguna entidad de seguridad que coincida con los parámetros especificados.
MultipleMatchesException	Más de una entidad de seguridad coincide con los parámetros especificados.
ArgumentException	identityType es una cadena vacía