PrincipalCollection.Add Méthode

Définition

Espace de noms:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paquet:

System.DirectoryServices.AccountManagement v8.0.0

Ajoute l'entité de sécurité spécifiée à la fin de la collection.

Surcharges

Add(ComputerPrincipal)	Ajoute l'objet ComputerPrincipal spécifié à la fin de la collection.
Add(GroupPrincipal)	Ajoute l'objet GroupPrincipal spécifié à la fin de la collection.
Add(Principal)	Ajoute l'objet Principal spécifié à la fin de la collection.
Add(UserPrincipal)	Ajoute l'objet UserPrincipal spécifié à la fin de la collection.
Add(PrincipalContext, IdentityType, String)	Recherche un objet Principal qui correspond aux paramètres et l'ajoute à la fin de la collection.

Remarques

Comme avec Remove et Contains, cette fonction comporte quatre surcharges, mais elles font toutes la même chose. Les surcharges supplémentaires sont implémentées uniquement pour améliorer la facilité d’utilisation, de sorte que les développeurs qui utilisent IntelliSense voient les surcharges qui prennent un UserPrincipalobjet , GroupPrincipalou ComputerPrincipal . Appeler une surcharge d’utilisateur, de groupe ou d’ordinateur équivaut exactement à appeler la Principal surcharge.

Add(ComputerPrincipal)

Source:

PrincipalCollection.cs

Ajoute l'objet ComputerPrincipal spécifié à la fin de la collection.

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)

Paramètres

computer

ComputerPrincipal

Objet ComputerPrincipal.

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
PrincipalExistsException	computer existe déjà dans la collection.

Add(GroupPrincipal)

Source:

PrincipalCollection.cs

Ajoute l'objet GroupPrincipal spécifié à la fin de la collection.

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)

Paramètres

group

GroupPrincipal

Objet ComputerPrincipal.

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
PrincipalExistsException	group existe déjà dans la collection.

Add(Principal)

Source:

PrincipalCollection.cs

Ajoute l'objet Principal spécifié à la fin de la collection.

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)

Paramètres

principal

Principal

Objet Principal.

Implémente

Add(T)

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
PrincipalExistsException	principal existe déjà dans la collection.

Add(UserPrincipal)

Source:

PrincipalCollection.cs

Ajoute l'objet UserPrincipal spécifié à la fin de la collection.

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)

Paramètres

user

UserPrincipal

Objet UserPrincipal.

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
PrincipalExistsException	user existe déjà dans la collection.

Add(PrincipalContext, IdentityType, String)

Source:

PrincipalCollection.cs

Recherche un objet Principal qui correspond aux paramètres et l'ajoute à la fin de la collection.

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)

Paramètres

context

PrincipalContext

Objet PrincipalContext pour l'entité de sécurité à ajouter à la collection.

identityType

IdentityType

Objet IdentityType qui spécifie le format de identityValue.

identityValue

String

Chaîne qui identifie le principal, au format spécifié par identityType.

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
PrincipalExistsException	Le principal correspondant à ces paramètres existe déjà dans la collection.
NoMatchingPrincipalException	Aucun principal correspondant aux paramètres spécifiés n’a été trouvé.
MultipleMatchesException	Plusieurs principaux correspondent aux paramètres spécifiés.
ArgumentException	identityType est une chaîne vide.