PrincipalCollection.Remove Méthode

Définition

Espace de noms:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

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.

Supprime le principal spécifié de la collection et retourne true si l’objet principal spécifié était membre de la collection, et false sinon (dans ce cas, aucune opération n’est effectuée).

Surcharges

Nom	Description
Remove(ComputerPrincipal)	Supprime l’objet spécifié ComputerPrincipal de la collection et retourne `true` si celui-ci ComputerPrincipal était membre de ce PrincipalCollectionfichier et `false` sinon (auquel cas la méthode n’effectue aucune opération).
Remove(GroupPrincipal)	Supprime l’objet spécifié GroupPrincipal de la collection et retourne `true` si celui-ci GroupPrincipal était membre de ce PrincipalCollectionfichier et `false` sinon (auquel cas la méthode n’effectue aucune opération).
Remove(Principal)	Supprime l’objet spécifié Principal de la collection et retourne `true` si celui-ci Principal était membre de ce PrincipalCollectionfichier et `false` sinon (auquel cas la méthode n’effectue aucune opération).
Remove(UserPrincipal)	Supprime l’objet spécifié UserPrincipal de la collection et retourne `true` si celui-ci UserPrincipal était membre de ce PrincipalCollectionfichier et `false` sinon (auquel cas la méthode n’effectue aucune opération).
Remove(PrincipalContext, IdentityType, String)	Recherche l’objet UserPrincipal spécifié par l’objet donné PrincipalContext et/`identityTypeidentityValue` la paire de la collection, puis retourne `true` si l’identification Principal était membre de ce PrincipalCollectionparamètre, et `false` sinon (dans ce cas, la méthode n’effectue aucune opération).

Remarques

Comme avec Add, et Contains il ya quatre surcharges à cette fonction, mais ils font tous la même chose. Les surcharges supplémentaires sont implémentées uniquement pour améliorer la facilité d’utilisation, afin que les développeurs utilisant IntelliSense voient les surcharges qui prennent un UserPrincipal, GroupPrincipalou ComputerPrincipal un objet. L’appel d’une des surcharges utilisateur, groupe ou ordinateur équivaut exactement à appeler la Principal surcharge.

Remove(ComputerPrincipal)

Supprime l’objet spécifié ComputerPrincipal de la collection et retourne true si celui-ci ComputerPrincipal était membre de ce PrincipalCollectionfichier et false sinon (auquel cas la méthode n’effectue aucune opération).

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

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

[<System.Security.SecurityCritical>]
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 ceci PrincipalCollection; sinon, false.

Attributs: SecurityCriticalAttribute

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 membre du groupe en vertu de son `primaryGroupId` attribut.

S’applique à

Remove(GroupPrincipal)

Supprime l’objet spécifié GroupPrincipal de la collection et retourne true si celui-ci GroupPrincipal était membre de ce PrincipalCollectionfichier et false sinon (auquel cas la méthode n’effectue aucune opération).

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

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.GroupPrincipal group);

[<System.Security.SecurityCritical>]
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 ceci PrincipalCollection; sinon, false.

Attributs: SecurityCriticalAttribute

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 membre du groupe en vertu de son `primaryGroupId` attribut.

S’applique à

Remove(Principal)

Supprime l’objet spécifié Principal de la collection et retourne true si celui-ci Principal était membre de ce PrincipalCollectionfichier et false sinon (auquel cas la méthode n’effectue aucune opération).

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

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.Principal principal);

[<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

Boolean

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

Implémente

Remove(T)

Attributs: SecurityCriticalAttribute

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 membre du groupe en vertu de son `primaryGroupId` attribut.

S’applique à

Remove(UserPrincipal)

Supprime l’objet spécifié UserPrincipal de la collection et retourne true si celui-ci UserPrincipal était membre de ce PrincipalCollectionfichier et false sinon (auquel cas la méthode n’effectue aucune opération).

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

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.UserPrincipal user);

[<System.Security.SecurityCritical>]
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 ceci PrincipalCollection; sinon, false.

Attributs: SecurityCriticalAttribute

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 membre du groupe en vertu de son `primaryGroupId` attribut.

S’applique à

Remove(PrincipalContext, IdentityType, String)

Recherche l’objet UserPrincipal spécifié par l’objet donné PrincipalContext et/identityTypeidentityValue la paire de la collection, puis retourne true si l’identification Principal était membre de ce PrincipalCollectionparamètre, et false sinon (dans ce cas, la méthode n’effectue aucune opération).

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

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

[<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

context: PrincipalContext

Objet PrincipalContext.

identityType: IdentityType

Qui IdentityType identifie le format de identityValue.

identityValue: String

Chaîne.

Retours

Boolean

true si l’identification Principal était membre de ceci PrincipalCollection; sinon, false.

Attributs: SecurityCriticalAttribute

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 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 existe 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 à

Commentaires

Cette page a-t-elle été utile ?