PrincipalCollection.Remove Metoda

Definice

Obor názvů:

System.DirectoryServices.AccountManagement

Sestavení:

System.DirectoryServices.AccountManagement.dll

Balíček:

System.DirectoryServices.AccountManagement v8.0.0

Odebere zadaný objekt zabezpečení z kolekce a vrátí true , pokud byl zadaný instanční objekt členem kolekce a false jinak (v takovém případě se neprovádí žádná operace).

Přetížení

Remove(ComputerPrincipal)	Odebere zadaný ComputerPrincipal objekt z kolekce a vrátí true , pokud ComputerPrincipal byl členem tohoto PrincipalCollectionobjektu , a false jinak (v takovém případě metoda neprovede žádnou operaci).
Remove(GroupPrincipal)	Odebere zadaný GroupPrincipal objekt z kolekce a vrátí true , pokud GroupPrincipal byl členem tohoto PrincipalCollectionobjektu , a false jinak (v takovém případě metoda neprovede žádnou operaci).
Remove(Principal)	Odebere zadaný Principal objekt z kolekce a vrátí true , pokud Principal byl členem tohoto PrincipalCollectionobjektu , a false jinak (v takovém případě metoda neprovede žádnou operaci).
Remove(UserPrincipal)	Odebere zadaný UserPrincipal objekt z kolekce a vrátí true , pokud UserPrincipal byl členem tohoto PrincipalCollectionobjektu , a false jinak (v takovém případě metoda neprovede žádnou operaci).
Remove(PrincipalContext, IdentityType, String)	UserPrincipal Vyhledá objekt určený danou PrincipalContext dvojicí a identityTypeidentityValue/z kolekce a vrátítrue, pokud byl identifikovaný Principal člen tohoto PrincipalCollectionfalse a jiného člena (v takovém případě metoda neprovádí žádnou operaci).

Poznámky

Stejně jako u AddContains a existují čtyři přetížení této funkce, ale všechna fungují stejně. Dodatečná přetížení jsou implementována pouze za účelem zlepšení použitelnosti, takže vývojáři používající Technologii IntelliSense uvidí přetížení, která přebírají UserPrincipalobjekt , GroupPrincipalnebo ComputerPrincipal . Volání libovolného z přetížení Uživatel, Skupina nebo Počítač je přesně ekvivalentní volání Principal přetížení.

Remove(ComputerPrincipal)

Zdroj:

PrincipalCollection.cs

Odebere zadaný ComputerPrincipal objekt z kolekce a vrátí true , pokud ComputerPrincipal byl členem tohoto PrincipalCollectionobjektu , a false jinak (v takovém případě metoda neprovede žádnou operaci).

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

Parametry

computer

ComputerPrincipal

Objekt ComputerPrincipal .

Návraty

Boolean

true pokud byl ComputerPrincipal členem , PrincipalCollectionjinak hodnota false.

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
InvalidOperationException	Tato metoda byla volána v kolekci Members pro skupinu domény a objekt zabezpečení domény, který se má odebrat, je členem skupiny na základě svého primaryGroupId atributu.

Remove(GroupPrincipal)

Zdroj:

PrincipalCollection.cs

Odebere zadaný GroupPrincipal objekt z kolekce a vrátí true , pokud GroupPrincipal byl členem tohoto PrincipalCollectionobjektu , a false jinak (v takovém případě metoda neprovede žádnou operaci).

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

Parametry

group

GroupPrincipal

Objekt GroupPrincipal .

Návraty

Boolean

true pokud byl GroupPrincipal členem , PrincipalCollectionjinak hodnota false.

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
InvalidOperationException	Tato metoda byla volána v kolekci Members pro skupinu domény a objekt zabezpečení domény, který se má odebrat, je členem skupiny na základě svého primaryGroupId atributu.

Remove(Principal)

Zdroj:

PrincipalCollection.cs

Odebere zadaný Principal objekt z kolekce a vrátí true , pokud Principal byl členem tohoto PrincipalCollectionobjektu , a false jinak (v takovém případě metoda neprovede žádnou operaci).

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

Parametry

principal

Principal

Objekt Principal .

Návraty

Boolean

true pokud byl Principal členem , PrincipalCollectionjinak hodnota false.

Implementuje

Remove(T)

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
InvalidOperationException	Tato metoda byla volána v kolekci Members pro skupinu domény a objekt zabezpečení domény, který se má odebrat, je členem skupiny na základě svého primaryGroupId atributu.

Remove(UserPrincipal)

Zdroj:

PrincipalCollection.cs

Odebere zadaný UserPrincipal objekt z kolekce a vrátí true , pokud UserPrincipal byl členem tohoto PrincipalCollectionobjektu , a false jinak (v takovém případě metoda neprovede žádnou operaci).

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

Parametry

user

UserPrincipal

Objekt UserPrincipal .

Návraty

Boolean

true pokud byl UserPrincipal členem , PrincipalCollectionjinak hodnota false.

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
InvalidOperationException	Tato metoda byla volána v kolekci Members pro skupinu domény a objekt zabezpečení domény, který se má odebrat, je členem skupiny na základě svého primaryGroupId atributu.

Remove(PrincipalContext, IdentityType, String)

Zdroj:

PrincipalCollection.cs

UserPrincipal Vyhledá objekt určený danou PrincipalContext dvojicí a identityTypeidentityValue/z kolekce a vrátítrue, pokud byl identifikovaný Principal člen tohoto PrincipalCollectionfalse a jiného člena (v takovém případě metoda neprovádí žádnou operaci).

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

Parametry

context

PrincipalContext

Objekt PrincipalContext .

identityType

IdentityType

Určuje IdentityType formát objektu identityValue.

identityValue

String

Řetězec.

Návraty

Boolean

truepokud byl identifikovaný Principal člen této PrincipalCollectionskupiny ; v opačném případě . false

Poznámky

Tato funkce může vyvolat následující výjimky:

Výjimka	Description
InvalidOperationException	Tato metoda byla volána v kolekci Members pro skupinu domény a objekt zabezpečení domény, který se má odebrat, je členem skupiny na základě svého primaryGroupId atributu.
NoMatchingPrincipalException	Nebyl nalezen žádný objekt zabezpečení odpovídající zadaným parametrům.
MultipleMatchesException	Více než jeden objekt zabezpečení odpovídá zadaným parametrům. Teoreticky by k tomu nemělo dojít, protože Add vyvolá výjimku, když dojde k pokusu o přidání duplicitních objektů zabezpečení do kolekce. Je však možné, že duplikát vytvořilo jiné rozhraní API.
ArgumentException	identityType je prázdný řetězec.