PrincipalCollection.Remove Metoda

Definicja

Usuwa określony podmiot zabezpieczeń z kolekcji i zwraca true, jeśli określony obiekt Principal był członkiem kolekcji i false w przeciwnym razie (w tym przypadku nie jest wykonywana żadna operacja).Removes the specified principal from the collection, and returns true if the specified principal object was a member of the collection, and false otherwise (in which case no operation is performed).

Przeciążenia

Remove(ComputerPrincipal)

Usuwa określony obiekt ComputerPrincipal z kolekcji i zwraca true, jeśli ComputerPrincipal był członkiem tego PrincipalCollectioni false w inny sposób (w tym przypadku metoda nie wykonuje operacji).Removes the specified ComputerPrincipal object from the collection, and returns true if the ComputerPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

Remove(GroupPrincipal)

Usuwa określony obiekt GroupPrincipal z kolekcji i zwraca true, jeśli GroupPrincipal był członkiem tego PrincipalCollectioni false w inny sposób (w tym przypadku metoda nie wykonuje operacji).Removes the specified GroupPrincipal object from the collection, and returns true if the GroupPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

Remove(Principal)

Usuwa określony obiekt Principal z kolekcji i zwraca true, jeśli Principal był członkiem tego PrincipalCollectioni false w inny sposób (w tym przypadku metoda nie wykonuje operacji).Removes the specified Principal object from the collection, and returns true if the Principal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

Remove(UserPrincipal)

Usuwa określony obiekt UserPrincipal z kolekcji i zwraca true, jeśli UserPrincipal był członkiem tego PrincipalCollectioni false w inny sposób (w tym przypadku metoda nie wykonuje operacji).Removes the specified UserPrincipal object from the collection, and returns true if the UserPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

Remove(PrincipalContext, IdentityType, String)

Znajduje obiekt UserPrincipal określony przez daną PrincipalContext i identityType/identityValue z kolekcji i zwraca true, jeśli zidentyfikowany Principal był członkiem tego PrincipalCollection, i false w przeciwnym razie (w tym przypadku metoda nie wykonuje operacji).Finds the UserPrincipal object specified by the given PrincipalContext and identityType/identityValue pair from the collection, and returns true if the identified Principal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

Uwagi

Podobnie jak w przypadku Addi Contains istnieją cztery przeciążenia tej funkcji, ale wszystkie wykonują te same czynności.As with Add, and Contains there are four overloads to this function, but they all do the same thing. Dodatkowe przeciążenia są implementowane tylko w celu poprawy użyteczności, dzięki czemu deweloperzy korzystający z technologii IntelliSense zobaczą przeciążenia przyjmujące UserPrincipal, GroupPrincipallub ComputerPrincipal obiektu.The extra overloads are only implemented to improve usability, so that developers using IntelliSense see overloads that take a UserPrincipal, GroupPrincipal, or ComputerPrincipal object. Wywołanie jednego z przeciążeń użytkownika, grupy lub komputera jest dokładnie równoważne do wywołania przeciążenia Principal.Calling any one of the User, Group, or Computer overloads is exactly equivalent to calling the Principal overload.

Remove(ComputerPrincipal)

Usuwa określony obiekt ComputerPrincipal z kolekcji i zwraca true, jeśli ComputerPrincipal był członkiem tego PrincipalCollectioni false w inny sposób (w tym przypadku metoda nie wykonuje operacji).Removes the specified ComputerPrincipal object from the collection, and returns true if the ComputerPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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
Public Function Remove (computer As ComputerPrincipal) As Boolean

Parametry

computer
ComputerPrincipal

Element ComputerPrincipal obiektu.A ComputerPrincipal object.

Zwraca

true, jeśli ComputerPrincipal był członkiem tego PrincipalCollection; w przeciwnym razie false.true if the ComputerPrincipal was a member of this PrincipalCollection; otherwise, false.

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
InvalidOperationException Ta metoda została wywołana w kolekcji Members dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego atrybutu primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.

Remove(GroupPrincipal)

Usuwa określony obiekt GroupPrincipal z kolekcji i zwraca true, jeśli GroupPrincipal był członkiem tego PrincipalCollectioni false w inny sposób (w tym przypadku metoda nie wykonuje operacji).Removes the specified GroupPrincipal object from the collection, and returns true if the GroupPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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
Public Function Remove (group As GroupPrincipal) As Boolean

Parametry

group
GroupPrincipal

Element GroupPrincipal obiektu.A GroupPrincipal object.

Zwraca

true, jeśli GroupPrincipal był członkiem tego PrincipalCollection; w przeciwnym razie false.true if the GroupPrincipal was a member of this PrincipalCollection; otherwise, false.

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
InvalidOperationException Ta metoda została wywołana w kolekcji Members dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego atrybutu primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.

Remove(Principal)

Usuwa określony obiekt Principal z kolekcji i zwraca true, jeśli Principal był członkiem tego PrincipalCollectioni false w inny sposób (w tym przypadku metoda nie wykonuje operacji).Removes the specified Principal object from the collection, and returns true if the Principal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

public:
 virtual 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

Parametry

principal
Principal

Element Principal obiektu.A Principal object.

Zwraca

true, jeśli Principal był członkiem tego PrincipalCollection; w przeciwnym razie false.true if the Principal was a member of this PrincipalCollection; otherwise, false.

Implementuje

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
InvalidOperationException Ta metoda została wywołana w kolekcji Members dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego atrybutu primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.

Remove(UserPrincipal)

Usuwa określony obiekt UserPrincipal z kolekcji i zwraca true, jeśli UserPrincipal był członkiem tego PrincipalCollectioni false w inny sposób (w tym przypadku metoda nie wykonuje operacji).Removes the specified UserPrincipal object from the collection, and returns true if the UserPrincipal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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
Public Function Remove (user As UserPrincipal) As Boolean

Parametry

user
UserPrincipal

Element UserPrincipal obiektu.A UserPrincipal object.

Zwraca

true, jeśli UserPrincipal był członkiem tego PrincipalCollection; w przeciwnym razie false.true if the UserPrincipal was a member of this PrincipalCollection; otherwise, false.

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
InvalidOperationException Ta metoda została wywołana w kolekcji Members dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego atrybutu primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.

Remove(PrincipalContext, IdentityType, String)

Znajduje obiekt UserPrincipal określony przez daną PrincipalContext i identityType/identityValue z kolekcji i zwraca true, jeśli zidentyfikowany Principal był członkiem tego PrincipalCollection, i false w przeciwnym razie (w tym przypadku metoda nie wykonuje operacji).Finds the UserPrincipal object specified by the given PrincipalContext and identityType/identityValue pair from the collection, and returns true if the identified Principal was a member of this PrincipalCollection, and false otherwise (in which case the method performs no operation).

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);
member this.Remove : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> bool

Parametry

context
PrincipalContext

Element PrincipalContext obiektu.A PrincipalContext object.

identityType
IdentityType

IdentityType, który identyfikuje format identityValue.An IdentityType that identifies the format of identityValue.

identityValue
String

Ciąg.A string.

Zwraca

true, jeśli zidentyfikowany Principal był członkiem tego PrincipalCollection. w przeciwnym razie false.true if the identified Principal was a member of this PrincipalCollection; otherwise, false.

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
InvalidOperationException Ta metoda została wywołana w kolekcji Members dla grupy domeny, a podmiot zabezpieczeń domeny, który ma zostać usunięty, jest członkiem grupy na podstawie jego atrybutu primaryGroupId.This method was called on the Members collection for a domain group, and the domain principal to be removed is a member of the group by virtue of its primaryGroupId attribute.
NoMatchingPrincipalException Nie znaleziono podmiotu pasującego do określonych parametrów.No principal matching the specified parameters was found.
MultipleMatchesException Więcej niż jeden podmiot zabezpieczeń pasuje do określonych parametrów.More than one principal matches the specified parameters. Teoretycznie nigdy tego nie powinno się zdarzyć, ponieważ Add zgłasza wyjątek, gdy istnieje próba dodania zduplikowanych podmiotów zabezpieczeń do kolekcji.In theory, this should never happen, because Add throws an exception when there is an attempt to add duplicate principals to the collection. Jednak jest możliwe, że inny interfejs API utworzył duplikat.However, it is possible that another API created the duplicate.
ArgumentException identityType jest ciągiem pustym.identityType is an empty string.

Dotyczy