PrincipalCollection.Remove Método

Definición

Espacio de nombres:

System.DirectoryServices.AccountManagement

Ensamblado:

System.DirectoryServices.AccountManagement.dll

Paquete:

System.DirectoryServices.AccountManagement v8.0.0

Quita la entidad de seguridad especificada de la colección y devuelve true si el objeto de entidad de seguridad especificado era miembro de la colección; en caso contrario, devuelve false (en cuyo caso no se realiza ninguna operación).

Sobrecargas

Remove(ComputerPrincipal)	Quita el objeto ComputerPrincipal especificado de la colección y devuelve true si ComputerPrincipal era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).
Remove(GroupPrincipal)	Quita el objeto GroupPrincipal especificado de la colección y devuelve true si GroupPrincipal era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).
Remove(Principal)	Quita el objeto Principal especificado de la colección y devuelve true si Principal era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).
Remove(UserPrincipal)	Quita el objeto UserPrincipal especificado de la colección y devuelve true si UserPrincipal era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).
Remove(PrincipalContext, IdentityType, String)	Busca el objeto UserPrincipal especificado por el objeto PrincipalContext y el par identityType/identityValue dados de la colección, y devuelve true si el objeto Principal identificado era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).

Comentarios

Al igual que con Add, y Contains hay cuatro sobrecargas para esta función, pero todas hacen lo mismo. Las sobrecargas adicionales solo se implementan para mejorar la facilidad de uso, de modo que los desarrolladores que usan IntelliSense vean las sobrecargas que toman un UserPrincipalobjeto , GroupPrincipalo ComputerPrincipal . Llamar a cualquiera de las sobrecargas de usuario, grupo o equipo es exactamente equivalente a llamar a la Principal sobrecarga.

Remove(ComputerPrincipal)

Source:

PrincipalCollection.cs

Quita el objeto ComputerPrincipal especificado de la colección y devuelve true si ComputerPrincipal era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).

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

Parámetros

computer

ComputerPrincipal

Un objeto ComputerPrincipal.

Devoluciones

Boolean

Devuelve true si el ComputerPrincipal era miembro de este elemento PrincipalCollection; false de lo contrario.

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
InvalidOperationException	Se llamó a este método en la Members colección para un grupo de dominio y la entidad de seguridad de dominio que se va a quitar es miembro del grupo en virtud de su primaryGroupId atributo.

Remove(GroupPrincipal)

Source:

PrincipalCollection.cs

Quita el objeto GroupPrincipal especificado de la colección y devuelve true si GroupPrincipal era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).

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

Parámetros

group

GroupPrincipal

Un objeto GroupPrincipal.

Devoluciones

Boolean

Devuelve true si el GroupPrincipal era miembro de este elemento PrincipalCollection; false de lo contrario.

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
InvalidOperationException	Se llamó a este método en la Members colección para un grupo de dominio y la entidad de seguridad de dominio que se va a quitar es miembro del grupo en virtud de su primaryGroupId atributo.

Remove(Principal)

Source:

PrincipalCollection.cs

Quita el objeto Principal especificado de la colección y devuelve true si Principal era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).

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

Parámetros

principal

Principal

Un objeto Principal.

Devoluciones

Boolean

Devuelve true si el Principal era miembro de este elemento PrincipalCollection; false de lo contrario.

Implementaciones

Remove(T)

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
InvalidOperationException	Se llamó a este método en la Members colección para un grupo de dominio y la entidad de seguridad de dominio que se va a quitar es miembro del grupo en virtud de su primaryGroupId atributo.

Remove(UserPrincipal)

Source:

PrincipalCollection.cs

Quita el objeto UserPrincipal especificado de la colección y devuelve true si UserPrincipal era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).

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

Parámetros

user

UserPrincipal

Un objeto UserPrincipal.

Devoluciones

Boolean

Devuelve true si el UserPrincipal era miembro de este elemento PrincipalCollection; false de lo contrario.

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
InvalidOperationException	Se llamó a este método en la Members colección para un grupo de dominio y la entidad de seguridad de dominio que se va a quitar es miembro del grupo en virtud de su primaryGroupId atributo.

Remove(PrincipalContext, IdentityType, String)

Source:

PrincipalCollection.cs

Busca el objeto UserPrincipal especificado por el objeto PrincipalContext y el par identityType/identityValue dados de la colección, y devuelve true si el objeto Principal identificado era miembro de esta colección PrincipalCollection; en caso contrario, devuelve false (y el método no realiza ninguna operación).

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

Parámetros

context

PrincipalContext

Un objeto PrincipalContext.

identityType

IdentityType

IdentityType que identifica el formato de identityValue.

identityValue

String

Una cadena.

Devoluciones

Boolean

Devuelve true si el Principal identificado era miembro de este elemento PrincipalCollection; false de lo contrario.

Comentarios

Esta función puede producir las siguientes excepciones:

Excepción	Descripción
InvalidOperationException	Se llamó a este método en la Members colección para un grupo de dominio y la entidad de seguridad de dominio que se va a quitar es miembro del grupo en virtud de su primaryGroupId atributo.
NoMatchingPrincipalException	No se encontró ninguna entidad de seguridad que coincida con los parámetros especificados.
MultipleMatchesException	Más de una entidad de seguridad coincide con los parámetros especificados. En teoría, esto nunca debería ocurrir, ya que Add produce una excepción cuando hay un intento de agregar entidades de seguridad duplicadas a la colección. Sin embargo, es posible que otra API haya creado el duplicado.
ArgumentException	identityType es una cadena vacía.