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).Removes the specified principal from the collection, and returns true if the specified principal object was a member of the collection, and false otherwise (in which case no operation is performed).

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).Removes the specified ComputerPrincipal object from the collection, and returns true if the ComputerPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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).Removes the specified GroupPrincipal object from the collection, and returns true if the GroupPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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).Removes the specified Principal object from the collection, and returns true if the Principal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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).Removes the specified UserPrincipal object from the collection, and returns true if the UserPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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).Finds the UserPrincipal object specified by the given PrincipalContext and identityType/identityValue pair from the collection, and returns true if the identified Principal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

Remarques

Comme avec Add, et Contains, il y a quatre surcharges de cette fonction, mais elles ont toutes la même signification.As with Add, 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, GroupPrincipal ou 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.

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).Removes the specified ComputerPrincipal object from the collection, and returns true if the ComputerPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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
Public Function Remove (computer As ComputerPrincipal) As Boolean

Paramètres

Retours

true si le ComputerPrincipal était membre de ce PrincipalCollection ; sinon, false.true if the ComputerPrincipal was a member of this PrincipalCollection; otherwise, false.

Attributs

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException DescriptionDescription
InvalidOperationException Cette méthode a été appelée sur la collection Members pour un groupe de domaine, et le principal de domaine à supprimer est membre du groupe en vertu de son attribut primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.

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).Removes the specified GroupPrincipal object from the collection, and returns true if the GroupPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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
Public Function Remove (group As GroupPrincipal) As Boolean

Paramètres

Retours

true si le GroupPrincipal était membre de ce PrincipalCollection ; sinon, false.true if the GroupPrincipal was a member of this PrincipalCollection; otherwise, false.

Attributs

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException DescriptionDescription
InvalidOperationException Cette méthode a été appelée sur la collection Members pour un groupe de domaine, et le principal de domaine à supprimer est membre du groupe en vertu de son attribut primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.

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).Removes the specified Principal object from the collection, and returns true if the Principal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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

Paramètres

principal
Principal

Objet Principal.A Principal object.

Retours

true si le Principal était membre de ce PrincipalCollection ; sinon, false.true if the Principal was a member of this PrincipalCollection; otherwise, false.

Implémente

Attributs

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException DescriptionDescription
InvalidOperationException Cette méthode a été appelée sur la collection Members pour un groupe de domaine, et le principal de domaine à supprimer est membre du groupe en vertu de son attribut primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.

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).Removes the specified UserPrincipal object from the collection, and returns true if the UserPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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
Public Function Remove (user As UserPrincipal) As Boolean

Paramètres

Retours

true si le UserPrincipal était membre de ce PrincipalCollection ; sinon, false.true if the UserPrincipal was a member of this PrincipalCollection; otherwise, false.

Attributs

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException DescriptionDescription
InvalidOperationException Cette méthode a été appelée sur la collection Members pour un groupe de domaine, et le principal de domaine à supprimer est membre du groupe en vertu de son attribut primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.

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).Finds the UserPrincipal object specified by the given PrincipalContext and identityType/identityValue pair from the collection, and returns true if the identified Principal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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

Paramètres

identityType
IdentityType

IdentityType qui identifie le format de identityValue.An IdentityType that identifies the format of identityValue.

identityValue
String

Chaîne.A string.

Retours

true si le Principal identifié était membre de ce PrincipalCollection ; sinon, false.true if the identified Principal was a member of this PrincipalCollection; otherwise, false.

Attributs

Remarques

Cette fonction peut lever les exceptions suivantes :This function can throw the following exceptions:

ExceptionException DescriptionDescription
InvalidOperationException Cette méthode a été appelée sur la collection Members pour un groupe de domaine, et le principal de domaine à supprimer est membre du groupe en vertu de son attribut primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.
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. En théorie, cela ne doit jamais se produire, car Add lève une exception en cas de tentative d’ajout d’un principal dupliqué à la collection.In theory, this should never happen, because Add throws an exception when there is an attempt to add duplicate principals to the collection. Toutefois, il est possible qu’une autre API ait créé le doublon.However, it is possible that another API created the duplicate.
ArgumentException identityType est une chaîne vide.identityType is an empty string.

S’applique à