PrincipalCollection.Remove Methode

Definition

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

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

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

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

Boolean

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

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.

Remove(GroupPrincipal)

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

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

Boolean

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

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.

Remove(Principal)

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

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

Boolean

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

Implementiert

Remove(T)

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.

Remove(UserPrincipal)

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

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

Boolean

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

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.

Remove(PrincipalContext, IdentityType, String)

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

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

Boolean

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

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.