PrincipalCollection.Add Method

Definition

Namespace:: 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.

Overloads

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.

Remarks

Comme avec Remove et Contains, il y a quatre surcharges de cette fonction, mais elles font toutes la même chose.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, GroupPrincipalou 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);

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)

Parameters

computer: ComputerPrincipal

Objet ComputerPrincipal .A ComputerPrincipal object.

Attributes: SecurityCriticalAttribute

Remarks

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);

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)

Parameters

group: GroupPrincipal

Objet ComputerPrincipal .A ComputerPrincipal object.

Attributes: SecurityCriticalAttribute

Remarks

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);

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

Public Sub Add (principal As Principal)

Parameters

principal: Principal

Objet Principal .A Principal object.

Implements

Add(T)

Attributes: SecurityCriticalAttribute

Remarks

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);

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)

Parameters

user: UserPrincipal

Objet UserPrincipalA UserPrincipal object

Attributes: SecurityCriticalAttribute

Remarks

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);

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

Public Sub Add (context As PrincipalContext, identityType As IdentityType, identityValue As String)

Parameters

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

Attributes: SecurityCriticalAttribute

Remarks

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 Method

Definition

Overloads

Remarks

Add(ComputerPrincipal)

Parameters

Remarks

Add(GroupPrincipal)

Parameters

Remarks

Add(Principal)

Parameters

Implements

Remarks

Add(UserPrincipal)

Parameters

Remarks

Add(PrincipalContext, IdentityType, String)

Parameters

Remarks

Applies to

Cette page est-elle utile ?

Cette page est-elle utile ?