Compartir vía


PrincipalCollection.Add Método

Definición

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
Source:
PrincipalCollection.cs
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);
[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)

Parámetros

computer
ComputerPrincipal

Un objeto ComputerPrincipal.

Atributos

Comentarios

Esta función puede producir las siguientes excepciones:

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

Se aplica a

Add(GroupPrincipal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[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)

Parámetros

Atributos

Comentarios

Esta función puede producir las siguientes excepciones:

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

Se aplica a

Add(Principal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[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)

Parámetros

principal
Principal

Un objeto Principal.

Implementaciones

Atributos

Comentarios

Esta función puede producir las siguientes excepciones:

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

Se aplica a

Add(UserPrincipal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[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)

Parámetros

user
UserPrincipal

Un objeto UserPrincipal.

Atributos

Comentarios

Esta función puede producir las siguientes excepciones:

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

Se aplica a

Add(PrincipalContext, IdentityType, String)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[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)

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.

Atributos

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

Se aplica a