Udostępnij za pośrednictwem


PrincipalCollection.Remove Metoda

Definicja

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
Źródło:
PrincipalCollection.cs
Ź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);
[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

Zwraca

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

Atrybuty

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)

Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs
Ź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);
[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

Zwraca

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

Atrybuty

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)

Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs
Ź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);
[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

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

Implementuje

Atrybuty

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)

Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs
Ź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);
[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

Zwraca

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

Atrybuty

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)

Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs
Ź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);
[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

Element IdentityType identyfikujący format identityValue.

identityValue
String

Ciąg.

Zwraca

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

Atrybuty

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