PrincipalCollection.Remove Methode

Definition

Namespace:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

Paket:: System.DirectoryServices.AccountManagement v11.0.0-preview.4.26230.115

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Überlädt

Name	Beschreibung
Remove(ComputerPrincipal)	Entfernt das angegebene ComputerPrincipal Objekt aus der Auflistung und gibt zurück `true` , wenn es ComputerPrincipal sich um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls `false` (in diesem Fall führt die Methode keinen Vorgang aus).
Remove(GroupPrincipal)	Entfernt das angegebene GroupPrincipal Objekt aus der Auflistung und gibt zurück `true` , wenn es GroupPrincipal sich um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls `false` (in diesem Fall führt die Methode keinen Vorgang aus).
Remove(Principal)	Entfernt das angegebene Principal Objekt aus der Auflistung und gibt zurück `true` , wenn es Principal sich um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls `false` (in diesem Fall führt die Methode keinen Vorgang aus).
Remove(UserPrincipal)	Entfernt das angegebene UserPrincipal Objekt aus der Auflistung und gibt zurück `true` , wenn es UserPrincipal sich um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls `false` (in diesem Fall führt die Methode keinen Vorgang aus).
Remove(PrincipalContext, IdentityType, String)	Sucht das UserPrincipal durch das angegebene PrincipalContext und`identityType`/`identityValue` paar aus der Auflistung angegebene Objekt und gibt zurück`true`, ob es sich bei dem identifizierten Principal Element um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls `false` (in diesem Fall führt die Methode keinen Vorgang aus).

Hinweise

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

Remove(ComputerPrincipal)

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Entfernt das angegebene ComputerPrincipal Objekt aus der Auflistung und gibt zurück true , wenn es ComputerPrincipal sich um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls false (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

Boolean

truewenn dies ComputerPrincipal mitglied PrincipalCollectionwar ; andernfalls . false

Attribute: SecurityCriticalAttribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Exception	Description
InvalidOperationException	Diese Methode wurde für die Members Sammlung einer Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist ein Mitglied der Gruppe aufgrund seines `primaryGroupId` Attributs.

Gilt für:

Remove(GroupPrincipal)

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Entfernt das angegebene GroupPrincipal Objekt aus der Auflistung und gibt zurück true , wenn es GroupPrincipal sich um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls false (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

Boolean

truewenn dies GroupPrincipal mitglied PrincipalCollectionwar ; andernfalls . false

Attribute: SecurityCriticalAttribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Exception	Description
InvalidOperationException	Diese Methode wurde für die Members Sammlung einer Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist ein Mitglied der Gruppe aufgrund seines `primaryGroupId` Attributs.

Gilt für:

Remove(Principal)

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Entfernt das angegebene Principal Objekt aus der Auflistung und gibt zurück true , wenn es Principal sich um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls false (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

Boolean

truewenn dies Principal mitglied PrincipalCollectionwar ; andernfalls . false

Implementiert

Remove(T)

Attribute: SecurityCriticalAttribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Exception	Description
InvalidOperationException	Diese Methode wurde für die Members Sammlung einer Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist ein Mitglied der Gruppe aufgrund seines `primaryGroupId` Attributs.

Gilt für:

Remove(UserPrincipal)

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Entfernt das angegebene UserPrincipal Objekt aus der Auflistung und gibt zurück true , wenn es UserPrincipal sich um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls false (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

Boolean

truewenn dies UserPrincipal mitglied PrincipalCollectionwar ; andernfalls . false

Attribute: SecurityCriticalAttribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Exception	Description
InvalidOperationException	Diese Methode wurde für die Members Sammlung einer Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist ein Mitglied der Gruppe aufgrund seines `primaryGroupId` Attributs.

Gilt für:

Remove(PrincipalContext, IdentityType, String)

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Quelle:: PrincipalCollection.cs

Sucht das UserPrincipal durch das angegebene PrincipalContext undidentityType/identityValue paar aus der Auflistung angegebene Objekt und gibt zurücktrue, ob es sich bei dem identifizierten Principal Element um ein Element dieses PrincipalCollectionObjekts handelt, andernfalls false (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 Objekt, das das Format von identityValue.

identityValue: String

Eine Zeichenfolge.

Gibt zurück

Boolean

true wenn es sich bei dem identifizierten Principal Element um ein Mitglied handelt PrincipalCollection; andernfalls false.

Attribute: SecurityCriticalAttribute

Hinweise

Diese Funktion kann die folgenden Ausnahmen auslösen:

Exception	Description
InvalidOperationException	Diese Methode wurde für die Members Sammlung einer Domänengruppe aufgerufen, und der zu entfernende Domänenprinzipal ist ein Mitglied der Gruppe aufgrund seines `primaryGroupId` Attributs.
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:

Feedback

War diese Seite hilfreich?