PrincipalCollection.Add Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- computer
- ComputerPrincipal
Objet ComputerPrincipal.
- 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
- group
- GroupPrincipal
Objet ComputerPrincipal.
- 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
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
- user
- UserPrincipal
Objet UserPrincipal.
- 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. |