PrincipalCollection.Remove Methode

Definitie

Naamruimte:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee verwijdert u de opgegeven principal uit de verzameling en wordt geretourneerd true als het opgegeven principal-object lid is van de verzameling en false anders (in dat geval wordt er geen bewerking uitgevoerd).

Overloads

Name	Description
Remove(ComputerPrincipal)	Hiermee verwijdert u het opgegeven ComputerPrincipal object uit de verzameling en retourneert `true` u of het ComputerPrincipal lid is van dit PrincipalCollectionobject en `false` anders (in dat geval voert de methode geen bewerking uit).
Remove(GroupPrincipal)	Hiermee verwijdert u het opgegeven GroupPrincipal object uit de verzameling en retourneert `true` u of het GroupPrincipal lid is van dit PrincipalCollectionobject en `false` anders (in dat geval voert de methode geen bewerking uit).
Remove(Principal)	Hiermee verwijdert u het opgegeven Principal object uit de verzameling en retourneert `true` u of het Principal lid is van dit PrincipalCollectionobject en `false` anders (in dat geval voert de methode geen bewerking uit).
Remove(UserPrincipal)	Hiermee verwijdert u het opgegeven UserPrincipal object uit de verzameling en retourneert `true` u of het UserPrincipal lid is van dit PrincipalCollectionobject en `false` anders (in dat geval voert de methode geen bewerking uit).
Remove(PrincipalContext, IdentityType, String)	Hiermee wordt het UserPrincipal object gevonden dat is opgegeven door de opgegeven PrincipalContext en `identityTypeidentityValue`/het paar uit de verzameling en wordt geretourneerd `true` als de geïdentificeerde Principal lid is van dit PrincipalCollectionobject en `false` anders (in welk geval de methode geen bewerking uitvoert).

Opmerkingen

Net als bij Add, en Contains er zijn vier overbelastingen voor deze functie, maar ze doen allemaal hetzelfde. De extra overbelastingen worden alleen geïmplementeerd om de bruikbaarheid te verbeteren, zodat ontwikkelaars die IntelliSense gebruiken overbelastingen zien die een UserPrincipal, GroupPrincipalof ComputerPrincipal object aannemen. Het aanroepen van een van de gebruikers-, groeps- of computeroverbelastingen komt precies overeen met het aanroepen van de Principal overbelasting.

Remove(ComputerPrincipal)

Hiermee verwijdert u het opgegeven ComputerPrincipal object uit de verzameling en retourneert true u of het ComputerPrincipal lid is van dit PrincipalCollectionobject en false anders (in dat geval voert de methode geen bewerking uit).

public:
 bool Remove(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool

Public Function Remove (computer As ComputerPrincipal) As Boolean

Parameters

computer: ComputerPrincipal

Een ComputerPrincipal-object.

Retouren

Boolean

true als het ComputerPrincipal lid was van dit PrincipalCollection, anders , false.

Kenmerken: SecurityCriticalAttribute

Opmerkingen

Deze functie kan de volgende uitzonderingen genereren:

Exception	Description
InvalidOperationException	Deze methode is aangeroepen voor de Members verzameling voor een domeingroep en de domeinprincipaal die moet worden verwijderd, is een lid van de groep op grond van het `primaryGroupId` kenmerk ervan.

Van toepassing op

Remove(GroupPrincipal)

Hiermee verwijdert u het opgegeven GroupPrincipal object uit de verzameling en retourneert true u of het GroupPrincipal lid is van dit PrincipalCollectionobject en false anders (in dat geval voert de methode geen bewerking uit).

public:
 bool Remove(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.GroupPrincipal group);

[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool

Public Function Remove (group As GroupPrincipal) As Boolean

Parameters

group: GroupPrincipal

Een GroupPrincipal-object.

Retouren

Boolean

true als het GroupPrincipal lid was van dit PrincipalCollection, anders , false.

Kenmerken: SecurityCriticalAttribute

Opmerkingen

Deze functie kan de volgende uitzonderingen genereren:

Exception	Description
InvalidOperationException	Deze methode is aangeroepen voor de Members verzameling voor een domeingroep en de domeinprincipaal die moet worden verwijderd, is een lid van de groep op grond van het `primaryGroupId` kenmerk ervan.

Van toepassing op

Remove(Principal)

Hiermee verwijdert u het opgegeven Principal object uit de verzameling en retourneert true u of het Principal lid is van dit PrincipalCollectionobject en false anders (in dat geval voert de methode geen bewerking uit).

public:
 virtual bool Remove(System::DirectoryServices::AccountManagement::Principal ^ principal);

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.Principal principal);

[<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

Parameters

principal: Principal

Een Principal-object.

Retouren

Boolean

true als het Principal lid was van dit PrincipalCollection, anders , false.

Implementeringen

Remove(T)

Kenmerken: SecurityCriticalAttribute

Opmerkingen

Deze functie kan de volgende uitzonderingen genereren:

Exception	Description
InvalidOperationException	Deze methode is aangeroepen voor de Members verzameling voor een domeingroep en de domeinprincipaal die moet worden verwijderd, is een lid van de groep op grond van het `primaryGroupId` kenmerk ervan.

Van toepassing op

Remove(UserPrincipal)

Hiermee verwijdert u het opgegeven UserPrincipal object uit de verzameling en retourneert true u of het UserPrincipal lid is van dit PrincipalCollectionobject en false anders (in dat geval voert de methode geen bewerking uit).

public:
 bool Remove(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.UserPrincipal user);

[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.UserPrincipal -> bool

Public Function Remove (user As UserPrincipal) As Boolean

Parameters

user: UserPrincipal

Een UserPrincipal-object.

Retouren

Boolean

true als het UserPrincipal lid was van dit PrincipalCollection, anders , false.

Kenmerken: SecurityCriticalAttribute

Opmerkingen

Deze functie kan de volgende uitzonderingen genereren:

Exception	Description
InvalidOperationException	Deze methode is aangeroepen voor de Members verzameling voor een domeingroep en de domeinprincipaal die moet worden verwijderd, is een lid van de groep op grond van het `primaryGroupId` kenmerk ervan.

Van toepassing op

Remove(PrincipalContext, IdentityType, String)

Hiermee wordt het UserPrincipal object gevonden dat is opgegeven door de opgegeven PrincipalContext en identityTypeidentityValue/het paar uit de verzameling en wordt geretourneerd true als de geïdentificeerde Principal lid is van dit PrincipalCollectionobject en false anders (in welk geval de methode geen bewerking uitvoert).

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

[<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

Parameters

context: PrincipalContext

Een PrincipalContext-object.

identityType: IdentityType

Een IdentityType die de indeling van identityValue.

identityValue: String

Een tekenreeks.

Retouren

Boolean

trueindien de geïdentificeerde Principal lid was van deze PrincipalCollection; anders . false

Kenmerken: SecurityCriticalAttribute

Opmerkingen

Deze functie kan de volgende uitzonderingen genereren:

Exception	Description
InvalidOperationException	Deze methode is aangeroepen voor de Members verzameling voor een domeingroep en de domeinprincipaal die moet worden verwijderd, is een lid van de groep op grond van het `primaryGroupId` kenmerk ervan.
NoMatchingPrincipalException	Er is geen principal gevonden die overeenkomt met de opgegeven parameters.
MultipleMatchesException	Meer dan één principal komt overeen met de opgegeven parameters. In theorie zou dit nooit moeten gebeuren, omdat Add er een uitzondering ontstaat wanneer er een poging is om dubbele principals toe te voegen aan de verzameling. Het is echter mogelijk dat een andere API het duplicaat heeft gemaakt.
ArgumentException	`identityType` is een lege tekenreeks.

Van toepassing op

Feedback

Is deze pagina nuttig?