Compartir a través de


PrincipalCollection.Remove Método

Definición

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
Source:
PrincipalCollection.cs
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);
[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

Parámetros

computer
ComputerPrincipal

Un objeto ComputerPrincipal.

Devoluciones

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

Atributos

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.

Se aplica a

Remove(GroupPrincipal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[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

Parámetros

group
GroupPrincipal

Un objeto GroupPrincipal.

Devoluciones

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

Atributos

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.

Se aplica a

Remove(Principal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[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

Parámetros

principal
Principal

Un objeto Principal.

Devoluciones

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

Implementaciones

Atributos

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.

Se aplica a

Remove(UserPrincipal)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[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

Parámetros

user
UserPrincipal

Un objeto UserPrincipal.

Devoluciones

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

Atributos

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.

Se aplica a

Remove(PrincipalContext, IdentityType, String)

Source:
PrincipalCollection.cs
Source:
PrincipalCollection.cs
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);
[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

Parámetros

context
PrincipalContext

Un objeto PrincipalContext.

identityType
IdentityType

IdentityType que identifica el formato de identityValue.

identityValue
String

Una cadena.

Devoluciones

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

Atributos

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.

Se aplica a