PrincipalCollection.Remove Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.DirectoryServices.AccountManagement

Zestaw:: System.DirectoryServices.AccountManagement.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Przeciążenia

Remove(ComputerPrincipal)	Usuwa określony ComputerPrincipal obiekt z kolekcji i zwraca `true` wartość , jeśli ComputerPrincipal element był elementem członkowskim tego PrincipalCollectionobiektu i `false` w przeciwnym razie (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ływanie dowolnego przeciążenia użytkownika, grupy lub komputera jest dokładnie równoważne wywołaniu Principal przeciążenia.

Remove(ComputerPrincipal)

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

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

computer: ComputerPrincipal

Obiekt ComputerPrincipal.

Zwraca

Boolean

true jeśli był ComputerPrincipal członkiem tego PrincipalCollectionelementu ; w przeciwnym razie false.

Atrybuty: SecurityCriticalAttribute

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.

Dotyczy

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).

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

group: GroupPrincipal

Obiekt GroupPrincipal.

Zwraca

Boolean

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

Atrybuty: SecurityCriticalAttribute

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.

Dotyczy

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).

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

Obiekt Principal.

Zwraca

Boolean

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

Implementuje

Remove(T)

Atrybuty: SecurityCriticalAttribute

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.

Dotyczy

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).

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

user: UserPrincipal

Obiekt UserPrincipal.

Zwraca

Boolean

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

Atrybuty: SecurityCriticalAttribute

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.

Dotyczy

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).

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

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 .

Atrybuty: SecurityCriticalAttribute

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.

Dotyczy