PrincipalCollection.Add Méthode

Définition

Espace de noms:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

Ajoute l'entité de sécurité spécifiée à la fin de la collection.Adds the specified principal to the end of the collection.

Surcharges

Add(ComputerPrincipal)	Ajoute l'objet ComputerPrincipal spécifié à la fin de la collection.Adds the specified ComputerPrincipal object to the end of the collection.
Add(GroupPrincipal)	Ajoute l'objet GroupPrincipal spécifié à la fin de la collection.Adds the specified GroupPrincipal object to the end of the collection.
Add(Principal)	Ajoute l'objet Principal spécifié à la fin de la collection.Adds the specified Principal object to the end of the collection.
Add(UserPrincipal)	Ajoute l'objet UserPrincipal spécifié à la fin de la collection.Adds the specified UserPrincipal object to the end of the collection.
Add(PrincipalContext, IdentityType, String)	Recherche un objet Principal qui correspond aux paramètres et l'ajoute à la fin de la collection.Searches for a Principal object that matches the parameters, and adds it to the end of the collection.

Remarques

Comme avec Remove et Contains, il y a quatre surcharges de cette fonction, mais elles ont toutes la même signification.As with Remove and Contains, There are four overloads to this function, but they all do the same thing. Les surcharges supplémentaires sont uniquement implémentées pour améliorer la convivialité, afin que les développeurs qui utilisent IntelliSense voient des surcharges qui prennent un objet UserPrincipal, GroupPrincipal ou ComputerPrincipal.The extra overloads are only implemented to improve usability, so that developers using IntelliSense see overloads that take a UserPrincipal, GroupPrincipal, or ComputerPrincipal object. L’appel de l’un des surcharges d’utilisateur, de groupe ou d’ordinateur équivaut exactement à l’appel de la surcharge Principal.Calling any one of the User, Group, or Computer overloads is exactly equivalent to calling the Principal overload.

Add(ComputerPrincipal)

Ajoute l'objet ComputerPrincipal spécifié à la fin de la collection.Adds the specified ComputerPrincipal object to the end of the collection.

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

Public Sub Add (computer As ComputerPrincipal)

Paramètres

computer: ComputerPrincipal

Objet ComputerPrincipal.A ComputerPrincipal object.

Attributs: SecurityCriticalAttribute

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException	DescriptionDescription
PrincipalExistsException	`computer` existe déjà dans la collection.`computer` already exists in the collection.

Add(GroupPrincipal)

Ajoute l'objet GroupPrincipal spécifié à la fin de la collection.Adds the specified GroupPrincipal object to the end of the collection.

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

Public Sub Add (group As GroupPrincipal)

Paramètres

group: GroupPrincipal

Objet ComputerPrincipal.A ComputerPrincipal object.

Attributs: SecurityCriticalAttribute

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException	DescriptionDescription
PrincipalExistsException	`group` existe déjà dans la collection.`group` already exists in the collection.

Add(Principal)

Ajoute l'objet Principal spécifié à la fin de la collection.Adds the specified Principal object to the end of the collection.

public:
 virtual 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

Paramètres

principal: Principal

Objet Principal.A Principal object.

Implémente

Add(T)

Attributs: SecurityCriticalAttribute

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException	DescriptionDescription
PrincipalExistsException	`principal` existe déjà dans la collection.`principal` already exists in the collection.

Add(UserPrincipal)

Ajoute l'objet UserPrincipal spécifié à la fin de la collection.Adds the specified UserPrincipal object to the end of the collection.

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

Public Sub Add (user As UserPrincipal)

Paramètres

user: UserPrincipal

Objet UserPrincipalA UserPrincipal object

Attributs: SecurityCriticalAttribute

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException	DescriptionDescription
PrincipalExistsException	`user` existe déjà dans la collection.`user` already exists in the collection.

Add(PrincipalContext, IdentityType, String)

Recherche un objet Principal qui correspond aux paramètres et l'ajoute à la fin de la collection.Searches for a Principal object that matches the parameters, and adds it to the end of the collection.

public:
 void Add(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::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

Paramètres

context: PrincipalContext

Objet PrincipalContext pour l'entité de sécurité à ajouter à la collection.The PrincipalContext object for the principal to be added to the collection.

identityType: IdentityType

Objet IdentityType qui spécifie le format de identityValue.An IdentityType object that specifies the format of identityValue

identityValue: String

Chaîne qui identifie l'entité de sécurité dans le format spécifié par identityType.A string that identifies the principal, in the format specified by identityType

Attributs: SecurityCriticalAttribute

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException	DescriptionDescription
PrincipalExistsException	Le principal correspondant à ces paramètres existe déjà dans la collection.The principal matching these parameters already exists in the collection.
NoMatchingPrincipalException	Aucun principal correspondant aux paramètres spécifiés n’a été trouvé.No principal matching the specified parameters was found.
MultipleMatchesException	Plus d’un principal correspond aux paramètres spécifiés.More than one principal matches the specified parameters.
ArgumentException	`identityType` est une chaîne vide.`identityType` is an empty string

PrincipalCollection.Add Méthode

Définition

Surcharges

Remarques

Add(ComputerPrincipal)

Paramètres

Remarques

Add(GroupPrincipal)

Paramètres

Remarques

Add(Principal)

Paramètres

Implémente

Remarques

Add(UserPrincipal)

Paramètres

Remarques

Add(PrincipalContext, IdentityType, String)

Paramètres

Remarques

S’applique à

Cette page est-elle utile ?

Cette page est-elle utile ?