PrincipalCollection.Remove Método

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Remove a entidade de segurança especificada da coleção e retorna true se o objeto de entidade de segurança especificado for um membro da coleção; caso contrário, retorna false (neste caso, nenhuma operação é executada).

Sobrecargas

Remove(ComputerPrincipal)	Remove o objeto ComputerPrincipal especificado da coleção e retorna true se o ComputerPrincipal era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).
Remove(GroupPrincipal)	Remove o objeto GroupPrincipal especificado da coleção e retorna true se o GroupPrincipal era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).
Remove(Principal)	Remove o objeto Principal especificado da coleção e retorna true se o Principal era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).
Remove(UserPrincipal)	Remove o objeto UserPrincipal especificado da coleção e retorna true se o UserPrincipal era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).
Remove(PrincipalContext, IdentityType, String)	Encontra o objeto UserPrincipal especificado pelo par PrincipalContext e identityType/identityValue da coleção e retorna true se o Principal identificado era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).

Comentários

Assim como acontece com Add, e Contains há quatro sobrecargas para essa função, mas todas elas fazem a mesma coisa. As sobrecargas extras são implementadas apenas para melhorar a usabilidade, para que os desenvolvedores que usam o IntelliSense vejam sobrecargas que usam um UserPrincipalobjeto , GroupPrincipalou ComputerPrincipal . Chamar qualquer uma das sobrecargas de Usuário, Grupo ou Computador é exatamente equivalente a chamar a Principal sobrecarga.

Remove(ComputerPrincipal)

Origem:

PrincipalCollection.cs

Remove o objeto ComputerPrincipal especificado da coleção e retorna true se o ComputerPrincipal era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).

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

Um objeto ComputerPrincipal.

Retornos

Boolean

true se o ComputerPrincipal era membro dessa PrincipalCollection; caso contrário, false.

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
InvalidOperationException	Esse método foi chamado na Members coleção para um grupo de domínio e a entidade de segurança de domínio a ser removida é um membro do grupo em virtude de seu primaryGroupId atributo.

Remove(GroupPrincipal)

Origem:

PrincipalCollection.cs

Remove o objeto GroupPrincipal especificado da coleção e retorna true se o GroupPrincipal era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).

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

Um objeto GroupPrincipal.

Retornos

Boolean

true se o GroupPrincipal era membro dessa PrincipalCollection; caso contrário, false.

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
InvalidOperationException	Esse método foi chamado na Members coleção para um grupo de domínio e a entidade de segurança de domínio a ser removida é um membro do grupo em virtude de seu primaryGroupId atributo.

Remove(Principal)

Origem:

PrincipalCollection.cs

Remove o objeto Principal especificado da coleção e retorna true se o Principal era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).

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

Um objeto Principal.

Retornos

Boolean

true se o Principal era membro dessa PrincipalCollection; caso contrário, false.

Implementações

Remove(T)

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
InvalidOperationException	Esse método foi chamado na Members coleção para um grupo de domínio e a entidade de segurança de domínio a ser removida é um membro do grupo em virtude de seu primaryGroupId atributo.

Remove(UserPrincipal)

Origem:

PrincipalCollection.cs

Remove o objeto UserPrincipal especificado da coleção e retorna true se o UserPrincipal era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).

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

Um objeto UserPrincipal.

Retornos

Boolean

true se o UserPrincipal era membro dessa PrincipalCollection; caso contrário, false.

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
InvalidOperationException	Esse método foi chamado na Members coleção para um grupo de domínio e a entidade de segurança de domínio a ser removida é um membro do grupo em virtude de seu primaryGroupId atributo.

Remove(PrincipalContext, IdentityType, String)

Origem:

PrincipalCollection.cs

Encontra o objeto UserPrincipal especificado pelo par PrincipalContext e identityType/identityValue da coleção e retorna true se o Principal identificado era membro deste PrincipalCollection; caso contrário, retorna false (neste caso, o método não realiza nenhuma operação).

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

Um objeto PrincipalContext.

identityType

IdentityType

Uma IdentityType que identifica o formato de identityValue.

identityValue

String

Uma cadeia de caracteres.

Retornos

Boolean

true se o Principal identificado era membro dessa PrincipalCollection. Caso contrário, false.

Comentários

Essa função pode gerar as seguintes exceções:

Exceção	Descrição
InvalidOperationException	Esse método foi chamado na Members coleção para um grupo de domínio e a entidade de segurança de domínio a ser removida é um membro do grupo em virtude de seu primaryGroupId atributo.
NoMatchingPrincipalException	Nenhuma entidade de segurança que corresponda aos parâmetros especificados foi encontrada.
MultipleMatchesException	Mais de uma entidade de segurança corresponde aos parâmetros especificados. Em teoria, isso nunca deve acontecer, pois Add gera uma exceção quando há uma tentativa de adicionar entidades de segurança duplicadas à coleção. No entanto, é possível que outra API tenha criado a duplicata.
ArgumentException	identityType é uma cadeia de caracteres vazia.