PrincipalCollection.Remove Méthode

Définition

Espace de noms:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paquet:

System.DirectoryServices.AccountManagement v8.0.0

Supprime l'entité de sécurité spécifiée de la collection et retourne la valeur true si l'objet Entité de sécurité spécifié était membre de la collection et la valeur false dans le cas contraire (aucune opération n'est alors effectuée).

Surcharges

Remove(ComputerPrincipal)	Supprime l'objet ComputerPrincipal spécifié de la collection et retourne la valeur true si ComputerPrincipal était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n'effectue alors aucune opération).
Remove(GroupPrincipal)	Supprime l'objet GroupPrincipal spécifié de la collection et retourne la valeur true si GroupPrincipal était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n'effectue alors aucune opération).
Remove(Principal)	Supprime l'objet Principal spécifié de la collection et retourne la valeur true si Principal était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n'effectue alors aucune opération).
Remove(UserPrincipal)	Supprime l'objet UserPrincipal spécifié de la collection et retourne la valeur true si UserPrincipal était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n'effectue alors aucune opération).
Remove(PrincipalContext, IdentityType, String)	Recherche l’objet UserPrincipal spécifié par la paire PrincipalContext et identityType/identityValue donnée de la collection, puis retourne la valeur true si le Principal identifié était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n’effectue alors aucune opération).

Remarques

Comme avec Add, 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.

Remove(ComputerPrincipal)

Source:

PrincipalCollection.cs

Supprime l'objet ComputerPrincipal spécifié de la collection et retourne la valeur true si ComputerPrincipal était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n'effectue alors aucune opération).

public:
 bool Remove(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);

public bool Remove (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

member this.Remove : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool

Public Function Remove (computer As ComputerPrincipal) As Boolean

Paramètres

computer

ComputerPrincipal

Objet ComputerPrincipal.

Retours

Boolean

true si le ComputerPrincipal était membre de ce PrincipalCollection ; sinon, false.

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
InvalidOperationException	Cette méthode a été appelée sur la Members collection d’un groupe de domaines, et le principal de domaine à supprimer est un membre du groupe en vertu de son primaryGroupId attribut.

Remove(GroupPrincipal)

Source:

PrincipalCollection.cs

Supprime l'objet GroupPrincipal spécifié de la collection et retourne la valeur true si GroupPrincipal était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n'effectue alors aucune opération).

public:
 bool Remove(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);

public bool Remove (System.DirectoryServices.AccountManagement.GroupPrincipal group);

member this.Remove : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool

Public Function Remove (group As GroupPrincipal) As Boolean

Paramètres

group

GroupPrincipal

Objet GroupPrincipal.

Retours

Boolean

true si le GroupPrincipal était membre de ce PrincipalCollection ; sinon, false.

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
InvalidOperationException	Cette méthode a été appelée sur la Members collection d’un groupe de domaines, et le principal de domaine à supprimer est un membre du groupe en vertu de son primaryGroupId attribut.

Remove(Principal)

Source:

PrincipalCollection.cs

Supprime l'objet Principal spécifié de la collection et retourne la valeur true si Principal était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n'effectue alors aucune opération).

public:
 virtual bool Remove(System::DirectoryServices::AccountManagement::Principal ^ principal);

public bool Remove (System.DirectoryServices.AccountManagement.Principal principal);

abstract member Remove : System.DirectoryServices.AccountManagement.Principal -> bool
override this.Remove : System.DirectoryServices.AccountManagement.Principal -> bool

Public Function Remove (principal As Principal) As Boolean

Paramètres

principal

Principal

Objet Principal.

Retours

Boolean

true si le Principal était membre de ce PrincipalCollection ; sinon, false.

Implémente

Remove(T)

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
InvalidOperationException	Cette méthode a été appelée sur la Members collection d’un groupe de domaines, et le principal de domaine à supprimer est un membre du groupe en vertu de son primaryGroupId attribut.

Remove(UserPrincipal)

Source:

PrincipalCollection.cs

Supprime l'objet UserPrincipal spécifié de la collection et retourne la valeur true si UserPrincipal était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n'effectue alors aucune opération).

public:
 bool Remove(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);

public bool Remove (System.DirectoryServices.AccountManagement.UserPrincipal user);

member this.Remove : System.DirectoryServices.AccountManagement.UserPrincipal -> bool

Public Function Remove (user As UserPrincipal) As Boolean

Paramètres

user

UserPrincipal

Objet UserPrincipal.

Retours

Boolean

true si le UserPrincipal était membre de ce PrincipalCollection ; sinon, false.

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
InvalidOperationException	Cette méthode a été appelée sur la Members collection d’un groupe de domaines, et le principal de domaine à supprimer est un membre du groupe en vertu de son primaryGroupId attribut.

Remove(PrincipalContext, IdentityType, String)

Source:

PrincipalCollection.cs

Recherche l’objet UserPrincipal spécifié par la paire PrincipalContext et identityType/identityValue donnée de la collection, puis retourne la valeur true si le Principal identifié était membre de PrincipalCollection et la valeur false dans le cas contraire (la méthode n’effectue alors aucune opération).

public:
 bool Remove(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public bool Remove (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

member this.Remove : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> bool

Public Function Remove (context As PrincipalContext, identityType As IdentityType, identityValue As String) As Boolean

Paramètres

context

PrincipalContext

Objet PrincipalContext.

identityType

IdentityType

IdentityType qui identifie le format de identityValue.

identityValue

String

Chaîne.

Retours

Boolean

true si le Principal identifié était membre de ce PrincipalCollection ; sinon, false.

Remarques

Cette fonction peut lever les exceptions suivantes :

Exception	Description
InvalidOperationException	Cette méthode a été appelée sur la Members collection d’un groupe de domaines, et le principal de domaine à supprimer est un membre du groupe en vertu de son primaryGroupId attribut.
NoMatchingPrincipalException	Aucun principal correspondant aux paramètres spécifiés n’a été trouvé.
MultipleMatchesException	Plusieurs principaux correspondent aux paramètres spécifiés. En théorie, cela ne devrait jamais se produire, car Add lève une exception lorsqu’il y a une tentative d’ajout de principaux dupliqués à la collection. Toutefois, il est possible qu’une autre API a créé le doublon.
ArgumentException	identityType est une chaîne vide.