Sdílet prostřednictvím


PrincipalCollection.Remove Metoda

Definice

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
Zdroj:
PrincipalCollection.cs
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);
[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

Parametry

Návraty

true pokud byl ComputerPrincipal členem , PrincipalCollectionjinak hodnota false.

Atributy

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.

Platí pro

Remove(GroupPrincipal)

Zdroj:
PrincipalCollection.cs
Zdroj:
PrincipalCollection.cs
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);
[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

Parametry

Návraty

true pokud byl GroupPrincipal členem , PrincipalCollectionjinak hodnota false.

Atributy

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.

Platí pro

Remove(Principal)

Zdroj:
PrincipalCollection.cs
Zdroj:
PrincipalCollection.cs
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);
[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

Parametry

principal
Principal

Objekt Principal .

Návraty

true pokud byl Principal členem , PrincipalCollectionjinak hodnota false.

Implementuje

Atributy

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.

Platí pro

Remove(UserPrincipal)

Zdroj:
PrincipalCollection.cs
Zdroj:
PrincipalCollection.cs
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);
[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

Parametry

Návraty

true pokud byl UserPrincipal členem , PrincipalCollectionjinak hodnota false.

Atributy

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.

Platí pro

Remove(PrincipalContext, IdentityType, String)

Zdroj:
PrincipalCollection.cs
Zdroj:
PrincipalCollection.cs
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);
[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

Parametry

identityType
IdentityType

Určuje IdentityType formát objektu identityValue.

identityValue
String

Řetězec.

Návraty

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

Atributy

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.

Platí pro