PrincipalCollection.Remove Método

Referência

Definição

Namespace:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

Pacote:: System.DirectoryServices.AccountManagement v6.0.0

Pacote:: System.DirectoryServices.AccountManagement v7.0.0

Pacote:: System.DirectoryServices.AccountManagement v8.0.0

Pacote:: System.DirectoryServices.AccountManagement v9.0.0-preview.2.24128.5

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Origem:: PrincipalCollection.cs

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

[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

Um objeto ComputerPrincipal.

Retornos

Boolean

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

Atributos: SecurityCriticalAttribute

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.

Aplica-se a

Remove(GroupPrincipal)

Origem:: PrincipalCollection.cs

Origem:: PrincipalCollection.cs

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

[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

Um objeto GroupPrincipal.

Retornos

Boolean

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

Atributos: SecurityCriticalAttribute

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.

Aplica-se a

Remove(Principal)

Origem:: PrincipalCollection.cs

Origem:: PrincipalCollection.cs

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

[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

Um objeto Principal.

Retornos

Boolean

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

Implementações

Remove(T)

Atributos: SecurityCriticalAttribute

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.

Aplica-se a

Remove(UserPrincipal)

Origem:: PrincipalCollection.cs

Origem:: PrincipalCollection.cs

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

[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

Um objeto UserPrincipal.

Retornos

Boolean

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

Atributos: SecurityCriticalAttribute

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.

Aplica-se a

Remove(PrincipalContext, IdentityType, String)

Origem:: PrincipalCollection.cs

Origem:: PrincipalCollection.cs

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

[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

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.

Atributos: SecurityCriticalAttribute

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.

Aplica-se a

Compartilhar via

PrincipalCollection.Remove Método

Definição

Sobrecargas

Comentários

Remove(ComputerPrincipal)

Parâmetros

Retornos

Comentários

Aplica-se a

Remove(GroupPrincipal)

Parâmetros

Retornos

Comentários

Aplica-se a

Remove(Principal)

Parâmetros

Retornos

Implementações

Comentários

Aplica-se a

Remove(UserPrincipal)

Parâmetros

Retornos

Comentários

Aplica-se a

Remove(PrincipalContext, IdentityType, String)

Parâmetros

Retornos

Comentários

Aplica-se a

Recursos adicionais