PrincipalCollection.Remove Metodo

Definizione

Spazio dei nomi:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacchetto:

System.DirectoryServices.AccountManagement v8.0.0

Rimuove l'entità di protezione specificata dall'insieme e restituisce true se l'oggetto Principal specificato è un membro dell'insieme, e false in caso contrario (nel qual caso non viene eseguita alcuna operazione).

Overload

Remove(ComputerPrincipal)	Rimuove l'oggetto ComputerPrincipal specificato dall'insieme e restituisce true se ComputerPrincipal è un membro di questo oggetto PrincipalCollection e false in caso contrario (non viene eseguita alcuna operazione).
Remove(GroupPrincipal)	Rimuove l'oggetto GroupPrincipal specificato dall'insieme e restituisce true se GroupPrincipal è un membro di questo oggetto PrincipalCollection e false in caso contrario (non viene eseguita alcuna operazione).
Remove(Principal)	Rimuove l'oggetto Principal specificato dall'insieme e restituisce true se Principal è un membro di questo oggetto PrincipalCollection e false in caso contrario (non viene eseguita alcuna operazione).
Remove(UserPrincipal)	Rimuove l'oggetto UserPrincipal specificato dall'insieme e restituisce true se UserPrincipal è un membro di questo oggetto PrincipalCollection e false in caso contrario (non viene eseguita alcuna operazione).
Remove(PrincipalContext, IdentityType, String)	Trova l'oggetto UserPrincipal specificato dall'oggetto PrincipalContext e dalla coppia identityType/identityValue determinati dalla raccolta e restituisce true se l'oggetto Principal identificato era un membro di questo oggetto PrincipalCollection; in caso contrario, false (nel qual caso non viene eseguita alcuna operazione).

Commenti

Come per Add, e Contains ci sono quattro overload per questa funzione, ma tutte eseguono la stessa operazione. Gli overload aggiuntivi vengono implementati solo per migliorare l'usabilità, in modo che gli sviluppatori che usano IntelliSense vedano gli overload che accettano un UserPrincipaloggetto , GroupPrincipalo ComputerPrincipal . La chiamata a uno degli overload utente, gruppo o computer equivale esattamente a chiamare l'overload Principal .

Remove(ComputerPrincipal)

Source:

PrincipalCollection.cs

Rimuove l'oggetto ComputerPrincipal specificato dall'insieme e restituisce true se ComputerPrincipal è un membro di questo oggetto PrincipalCollection e false in caso contrario (non viene eseguita alcuna operazione).

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

Parametri

computer

ComputerPrincipal

Un oggetto ComputerPrincipal.

Restituisce

Boolean

true se ComputerPrincipal è un membro dell'oggetto PrincipalCollection; in caso contrario false.

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
InvalidOperationException	Questo metodo è stato chiamato nella Members raccolta per un gruppo di dominio e l'entità di dominio da rimuovere è un membro del gruppo in virtù del relativo primaryGroupId attributo.

Remove(GroupPrincipal)

Source:

PrincipalCollection.cs

Rimuove l'oggetto GroupPrincipal specificato dall'insieme e restituisce true se GroupPrincipal è un membro di questo oggetto PrincipalCollection e false in caso contrario (non viene eseguita alcuna operazione).

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

Parametri

group

GroupPrincipal

Un oggetto GroupPrincipal.

Restituisce

Boolean

true se GroupPrincipal è un membro dell'oggetto PrincipalCollection; in caso contrario false.

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
InvalidOperationException	Questo metodo è stato chiamato nella Members raccolta per un gruppo di dominio e l'entità di dominio da rimuovere è un membro del gruppo in virtù del relativo primaryGroupId attributo.

Remove(Principal)

Source:

PrincipalCollection.cs

Rimuove l'oggetto Principal specificato dall'insieme e restituisce true se Principal è un membro di questo oggetto PrincipalCollection e false in caso contrario (non viene eseguita alcuna operazione).

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

Parametri

principal

Principal

Un oggetto Principal.

Restituisce

Boolean

true se Principal è un membro dell'oggetto PrincipalCollection; in caso contrario false.

Implementazioni

Remove(T)

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
InvalidOperationException	Questo metodo è stato chiamato nella Members raccolta per un gruppo di dominio e l'entità di dominio da rimuovere è un membro del gruppo in virtù del relativo primaryGroupId attributo.

Remove(UserPrincipal)

Source:

PrincipalCollection.cs

Rimuove l'oggetto UserPrincipal specificato dall'insieme e restituisce true se UserPrincipal è un membro di questo oggetto PrincipalCollection e false in caso contrario (non viene eseguita alcuna operazione).

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

Parametri

user

UserPrincipal

Un oggetto UserPrincipal.

Restituisce

Boolean

true se UserPrincipal è un membro dell'oggetto PrincipalCollection; in caso contrario false.

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
InvalidOperationException	Questo metodo è stato chiamato nella Members raccolta per un gruppo di dominio e l'entità di dominio da rimuovere è un membro del gruppo in virtù del relativo primaryGroupId attributo.

Remove(PrincipalContext, IdentityType, String)

Source:

PrincipalCollection.cs

Trova l'oggetto UserPrincipal specificato dall'oggetto PrincipalContext e dalla coppia identityType/identityValue determinati dalla raccolta e restituisce true se l'oggetto Principal identificato era un membro di questo oggetto PrincipalCollection; in caso contrario, false (nel qual caso non viene eseguita alcuna operazione).

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

Parametri

context

PrincipalContext

Un oggetto PrincipalContext.

identityType

IdentityType

Oggetto IdentityType che identifica il formato di identityValue.

identityValue

String

Stringa.

Restituisce

Boolean

true se l'oggetto Principal identificato era un membro dell'oggetto PrincipalCollection; in caso contrario false.

Commenti

Questa funzione può generare le eccezioni seguenti:

Eccezione	Descrizione
InvalidOperationException	Questo metodo è stato chiamato nella Members raccolta per un gruppo di dominio e l'entità di dominio da rimuovere è un membro del gruppo in virtù del relativo primaryGroupId attributo.
NoMatchingPrincipalException	Non è stata trovata alcuna entità corrispondente ai parametri specificati.
MultipleMatchesException	Più di un'entità corrisponde ai parametri specificati. In teoria, questo non dovrebbe mai verificarsi, perché Add genera un'eccezione quando si tenta di aggiungere entità duplicate alla raccolta. Tuttavia, è possibile che un'altra API ha creato il duplicato.
ArgumentException	Il parametro identityType è una stringa vuota.