Partager via


PrincipalCollection.Add Méthode

Définition

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

Paramètres

Attributs

Remarques

Cette fonction peut lever les exceptions suivantes :

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

S’applique à

Add(GroupPrincipal)

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

Paramètres

Attributs

Remarques

Cette fonction peut lever les exceptions suivantes :

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

S’applique à

Add(Principal)

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

Paramètres

principal
Principal

Objet Principal.

Implémente

Attributs

Remarques

Cette fonction peut lever les exceptions suivantes :

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

S’applique à

Add(UserPrincipal)

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

Paramètres

Attributs

Remarques

Cette fonction peut lever les exceptions suivantes :

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

S’applique à

Add(PrincipalContext, IdentityType, String)

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

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.

Attributs

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.

S’applique à