PrincipalCollection.Remove Metoda

Definicja

Przestrzeń nazw:

System.DirectoryServices.AccountManagement

Zestaw:

System.DirectoryServices.AccountManagement.dll

Pakiet:

System.DirectoryServices.AccountManagement v8.0.0

Usuwa określonego podmiotu z kolekcji i zwraca wartość true , jeśli określony obiekt podmiotu zabezpieczeń był elementem członkowskim kolekcji, a false w przeciwnym razie (w tym przypadku nie jest wykonywana żadna operacja).

Przeciążenia

Remove(ComputerPrincipal)	Usuwa określony ComputerPrincipal obiekt z kolekcji i zwraca wartość true , jeśli ComputerPrincipal element był elementem członkowskim tego PrincipalCollectionobiektu i false w inny sposób (w takim przypadku metoda nie wykonuje żadnej operacji).
Remove(GroupPrincipal)	Usuwa określony GroupPrincipal obiekt z kolekcji i zwraca wartość true , jeśli GroupPrincipal element był elementem członkowskim tego PrincipalCollectionobiektu i false w inny sposób (w takim przypadku metoda nie wykonuje żadnej operacji).
Remove(Principal)	Usuwa określony Principal obiekt z kolekcji i zwraca wartość true , jeśli Principal element był elementem członkowskim tego PrincipalCollectionobiektu i false w inny sposób (w takim przypadku metoda nie wykonuje żadnej operacji).
Remove(UserPrincipal)	Usuwa określony UserPrincipal obiekt z kolekcji i zwraca wartość true , jeśli UserPrincipal element był elementem członkowskim tego PrincipalCollectionobiektu i false w inny sposób (w takim przypadku metoda nie wykonuje żadnej operacji).
Remove(PrincipalContext, IdentityType, String)	UserPrincipal Znajduje obiekt określony przez daną PrincipalContext parę i identityTypeidentityValue/z kolekcji i zwraca true wartość , jeśli zidentyfikowany Principal był elementem członkowskim tego PrincipalCollectionelementu , i false w przeciwnym razie (w takim przypadku metoda nie wykonuje żadnej operacji).

Uwagi

Podobnie jak w przypadku Addfunkcji , i Contains istnieją cztery przeciążenia tej funkcji, ale wszystkie robią to samo. Dodatkowe przeciążenia są implementowane tylko w celu zwiększenia użyteczności, dzięki czemu deweloperzy korzystający z funkcji IntelliSense widzą przeciążenia, które przyjmują UserPrincipalobiekt , GroupPrincipallub ComputerPrincipal . Wywołanie dowolnego przeciążenia użytkownika, grupy lub komputera jest dokładnie równoważne wywołaniu Principal przeciążenia.

Remove(ComputerPrincipal)

Źródło:

PrincipalCollection.cs

Usuwa określony ComputerPrincipal obiekt z kolekcji i zwraca wartość true , jeśli ComputerPrincipal element był elementem członkowskim tego PrincipalCollectionobiektu i false w inny sposób (w takim przypadku metoda nie wykonuje żadnej operacji).

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

Obiekt ComputerPrincipal.

Zwraca

Boolean

trueComputerPrincipal jeśli był członkiem tego PrincipalCollectionobiektu ; w przeciwnym razie false.

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
InvalidOperationException	Ta metoda została wywołana w Members kolekcji dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego primaryGroupId atrybutu.

Remove(GroupPrincipal)

Źródło:

PrincipalCollection.cs

Usuwa określony GroupPrincipal obiekt z kolekcji i zwraca wartość true , jeśli GroupPrincipal element był elementem członkowskim tego PrincipalCollectionobiektu i false w inny sposób (w takim przypadku metoda nie wykonuje żadnej operacji).

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

Obiekt GroupPrincipal.

Zwraca

Boolean

trueGroupPrincipal jeśli był członkiem tego PrincipalCollectionobiektu ; w przeciwnym razie false.

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
InvalidOperationException	Ta metoda została wywołana w Members kolekcji dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego primaryGroupId atrybutu.

Remove(Principal)

Źródło:

PrincipalCollection.cs

Usuwa określony Principal obiekt z kolekcji i zwraca wartość true , jeśli Principal element był elementem członkowskim tego PrincipalCollectionobiektu i false w inny sposób (w takim przypadku metoda nie wykonuje żadnej operacji).

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

Obiekt Principal.

Zwraca

Boolean

truePrincipal jeśli był członkiem tego PrincipalCollectionobiektu ; w przeciwnym razie false.

Implementuje

Remove(T)

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
InvalidOperationException	Ta metoda została wywołana w Members kolekcji dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego primaryGroupId atrybutu.

Remove(UserPrincipal)

Źródło:

PrincipalCollection.cs

Usuwa określony UserPrincipal obiekt z kolekcji i zwraca wartość true , jeśli UserPrincipal element był elementem członkowskim tego PrincipalCollectionobiektu i false w inny sposób (w takim przypadku metoda nie wykonuje żadnej operacji).

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

Obiekt UserPrincipal.

Zwraca

Boolean

trueUserPrincipal jeśli był członkiem tego PrincipalCollectionobiektu ; w przeciwnym razie false.

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
InvalidOperationException	Ta metoda została wywołana w Members kolekcji dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego primaryGroupId atrybutu.

Remove(PrincipalContext, IdentityType, String)

Źródło:

PrincipalCollection.cs

UserPrincipal Znajduje obiekt określony przez daną PrincipalContext parę i identityTypeidentityValue/z kolekcji i zwraca true wartość , jeśli zidentyfikowany Principal był elementem członkowskim tego PrincipalCollectionelementu , i false w przeciwnym razie (w takim przypadku metoda nie wykonuje żadnej operacji).

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

Obiekt PrincipalContext.

identityType

IdentityType

Element IdentityType identyfikujący format identityValue.

identityValue

String

Ciąg.

Zwraca

Boolean

true jeśli zidentyfikowany Principal był członkiem tego PrincipalCollectionobiektu false; w przeciwnym razie .

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
InvalidOperationException	Ta metoda została wywołana w Members kolekcji dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego primaryGroupId atrybutu.
NoMatchingPrincipalException	Nie znaleziono podmiotu zabezpieczeń pasującego do określonych parametrów.
MultipleMatchesException	Więcej niż jeden podmiot zabezpieczeń jest zgodny z określonymi parametrami. Teoretycznie nigdy nie powinno się tak zdarzyć, ponieważ Add zgłasza wyjątek podczas próby dodania zduplikowanych podmiotów zabezpieczeń do kolekcji. Istnieje jednak możliwość utworzenia duplikatu przez inny interfejs API.
ArgumentException	identityType jest pustym ciągiem.