Freigeben über


PrincipalCollection.Remove Methode

Definition

Entfernt den angegebenen Prinzipal aus der Auflistung und gibt true zurück, wenn das angegebene Prinzipalobjekt ein Member der Auflistung war. Andernfalls wird false zurückgegeben (in diesem Fall wird kein Vorgang ausgeführt).

Überlädt

Remove(ComputerPrincipal)

Entfernt das angegebene ComputerPrincipal-Objekt aus der Auflistung und gibt true zurück, wenn der ComputerPrincipal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

Remove(GroupPrincipal)

Entfernt das angegebene GroupPrincipal-Objekt aus der Auflistung und gibt true zurück, wenn der GroupPrincipal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

Remove(Principal)

Entfernt das angegebene Principal-Objekt aus der Auflistung und gibt true zurück, wenn der Principal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

Remove(UserPrincipal)

Entfernt das angegebene UserPrincipal-Objekt aus der Auflistung und gibt true zurück, wenn der UserPrincipal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

Remove(PrincipalContext, IdentityType, String)

Sucht das UserPrincipal-Objekt, das durch den angegebenen PrincipalContext und das identityType/identityValue-Paar angegeben wird, in der Auflistung und gibt true zurück, wenn der identifizierte Principal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

Hinweise

Wie bei Addund Contains gibt es vier Überladungen für diese Funktion, aber sie tun alle dasselbe. Die zusätzlichen Überladungen werden nur implementiert, um die Benutzerfreundlichkeit zu verbessern, sodass Entwickler, die IntelliSense verwenden, Überladungen sehen, die ein -, GroupPrincipal- UserPrincipaloder ComputerPrincipal -Objekt annehmen. Das Aufrufen einer der Benutzer-, Gruppen- oder Computerüberladungen entspricht genau dem Aufrufen der Principal Überladung.

Remove(ComputerPrincipal)

Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs

Entfernt das angegebene ComputerPrincipal-Objekt aus der Auflistung und gibt true zurück, wenn der ComputerPrincipal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

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

Parameter

computer
ComputerPrincipal

Ein ComputerPrincipal-Objekt.

Gibt zurück

true, wenn ComputerPrincipal ein Member von PrincipalCollection war, andernfalls false.

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme Beschreibung
InvalidOperationException Diese Methode wurde für die Members Auflistung für eine Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist aufgrund seines primaryGroupId Attributs Mitglied der Gruppe.

Gilt für:

Remove(GroupPrincipal)

Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs

Entfernt das angegebene GroupPrincipal-Objekt aus der Auflistung und gibt true zurück, wenn der GroupPrincipal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

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

Parameter

group
GroupPrincipal

Ein GroupPrincipal-Objekt.

Gibt zurück

true, wenn GroupPrincipal ein Member von PrincipalCollection war, andernfalls false.

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme Beschreibung
InvalidOperationException Diese Methode wurde für die Members Auflistung für eine Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist aufgrund seines primaryGroupId Attributs Mitglied der Gruppe.

Gilt für:

Remove(Principal)

Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs

Entfernt das angegebene Principal-Objekt aus der Auflistung und gibt true zurück, wenn der Principal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

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

Parameter

principal
Principal

Ein Principal-Objekt.

Gibt zurück

true, wenn Principal ein Member von PrincipalCollection war, andernfalls false.

Implementiert

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme Beschreibung
InvalidOperationException Diese Methode wurde für die Members Auflistung für eine Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist aufgrund seines primaryGroupId Attributs Mitglied der Gruppe.

Gilt für:

Remove(UserPrincipal)

Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs

Entfernt das angegebene UserPrincipal-Objekt aus der Auflistung und gibt true zurück, wenn der UserPrincipal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

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

Parameter

user
UserPrincipal

Ein UserPrincipal-Objekt.

Gibt zurück

true, wenn UserPrincipal ein Member von PrincipalCollection war, andernfalls false.

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme Beschreibung
InvalidOperationException Diese Methode wurde für die Members Auflistung für eine Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist aufgrund seines primaryGroupId Attributs Mitglied der Gruppe.

Gilt für:

Remove(PrincipalContext, IdentityType, String)

Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs
Quelle:
PrincipalCollection.cs

Sucht das UserPrincipal-Objekt, das durch den angegebenen PrincipalContext und das identityType/identityValue-Paar angegeben wird, in der Auflistung und gibt true zurück, wenn der identifizierte Principal ein Member dieser PrincipalCollection war. Andernfalls wird false zurückgegeben (in diesem Fall führt die Methode keinen Vorgang aus).

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

Parameter

context
PrincipalContext

Ein PrincipalContext-Objekt.

identityType
IdentityType

Ein IdentityType, der das Format von identityValue bezeichnet.

identityValue
String

Eine Zeichenfolge.

Gibt zurück

true, wenn das identifizierte Principal-Objekt ein Member von PrincipalCollection war, andernfalls false.

Attribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Ausnahme Beschreibung
InvalidOperationException Diese Methode wurde für die Members Auflistung für eine Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist aufgrund seines primaryGroupId Attributs Mitglied der Gruppe.
NoMatchingPrincipalException Es wurde kein Prinzipal gefunden, der den angegebenen Parametern entspricht.
MultipleMatchesException Mehrere Prinzipale entsprechen den angegebenen Parametern. Theoretisch sollte dies niemals geschehen, da Add eine Ausnahme ausgelöst wird, wenn versucht wird, der Auflistung doppelte Prinzipale hinzuzufügen. Es ist jedoch möglich, dass eine andere API das Duplikat erstellt hat.
ArgumentException identityType ist eine leere Zeichenfolge.

Gilt für: