Partager via


PrincipalCollection.Remove Méthode

Définition

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
Source:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Remove (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
member this.Remove : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool
[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool
Public Function Remove (computer As ComputerPrincipal) As Boolean

Paramètres

Retours

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

Attributs

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.

S’applique à

Remove(GroupPrincipal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Remove (System.DirectoryServices.AccountManagement.GroupPrincipal group);
member this.Remove : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool
[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool
Public Function Remove (group As GroupPrincipal) As Boolean

Paramètres

Retours

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

Attributs

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.

S’applique à

Remove(Principal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Remove (System.DirectoryServices.AccountManagement.Principal principal);
abstract member Remove : System.DirectoryServices.AccountManagement.Principal -> bool
override this.Remove : System.DirectoryServices.AccountManagement.Principal -> bool
[<System.Security.SecurityCritical>]
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

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

Implémente

Attributs

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.

S’applique à

Remove(UserPrincipal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Remove (System.DirectoryServices.AccountManagement.UserPrincipal user);
member this.Remove : System.DirectoryServices.AccountManagement.UserPrincipal -> bool
[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.UserPrincipal -> bool
Public Function Remove (user As UserPrincipal) As Boolean

Paramètres

Retours

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

Attributs

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.

S’applique à

Remove(PrincipalContext, IdentityType, String)

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

identityType
IdentityType

IdentityType qui identifie le format de identityValue.

identityValue
String

Chaîne.

Retours

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

Attributs

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.

S’applique à