PrincipalCollection.Contains Método

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Retorna um valor que indica se o Principal especificado é um membro do PrincipalCollection. A Principal pode ser especificada da mesma maneira que nos métodos Add.

Sobrecargas

Contains(ComputerPrincipal)	Retorna um valor que indica se a coleção contém o objeto ComputerPrincipal especificado.
Contains(GroupPrincipal)	Retorna um valor que indica se a coleção contém o objeto GroupPrincipal especificado.
Contains(Principal)	Retorna um valor que indica se a coleção contém o objeto Principal especificado.
Contains(UserPrincipal)	Retorna um valor que indica se a coleção contém o objeto UserPrincipal especificado.
Contains(PrincipalContext, IdentityType, String)	Retorna um valor indicando se o objeto Principal que corresponde ao par identityType/identityValue está na coleção.

Comentários

Assim como acontece com Add, e Remove há quatro sobrecargas nessa 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 levam um UserPrincipalobjeto , GroupPrincipalou ComputerPrincipal . Chamar qualquer uma das sobrecargas de Usuário, Grupo ou Computador é exatamente equivalente a chamar a Principal sobrecarga.

Contains(ComputerPrincipal)

Origem:

PrincipalCollection.cs

Retorna um valor que indica se a coleção contém o objeto ComputerPrincipal especificado.

public:
 bool Contains(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);

public bool Contains (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

member this.Contains : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool

Public Function Contains (computer As ComputerPrincipal) As Boolean

Parâmetros

computer

ComputerPrincipal

Um objeto ComputerPrincipal.

Retornos

Boolean

true se a coleção contiver o objeto especificado; caso contrário, false.

Contains(GroupPrincipal)

Origem:

PrincipalCollection.cs

Retorna um valor que indica se a coleção contém o objeto GroupPrincipal especificado.

public:
 bool Contains(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);

public bool Contains (System.DirectoryServices.AccountManagement.GroupPrincipal group);

member this.Contains : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool

Public Function Contains (group As GroupPrincipal) As Boolean

Parâmetros

group

GroupPrincipal

Um objeto GroupPrincipal.

Retornos

Boolean

true se a coleção contiver o objeto especificado; caso contrário, false.

Contains(Principal)

Origem:

PrincipalCollection.cs

Retorna um valor que indica se a coleção contém o objeto Principal especificado.

public:
 virtual bool Contains(System::DirectoryServices::AccountManagement::Principal ^ principal);

public bool Contains (System.DirectoryServices.AccountManagement.Principal principal);

abstract member Contains : System.DirectoryServices.AccountManagement.Principal -> bool
override this.Contains : System.DirectoryServices.AccountManagement.Principal -> bool

Public Function Contains (principal As Principal) As Boolean

Parâmetros

principal

Principal

Um objeto Principal.

Retornos

Boolean

true se a coleção contiver o objeto especificado; caso contrário, false.

Implementações

Contains(T)

Contains(UserPrincipal)

Origem:

PrincipalCollection.cs

Retorna um valor que indica se a coleção contém o objeto UserPrincipal especificado.

public:
 bool Contains(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);

public bool Contains (System.DirectoryServices.AccountManagement.UserPrincipal user);

member this.Contains : System.DirectoryServices.AccountManagement.UserPrincipal -> bool

Public Function Contains (user As UserPrincipal) As Boolean

Parâmetros

user

UserPrincipal

Um objeto UserPrincipal.

Retornos

Boolean

true se a coleção contiver o objeto especificado; caso contrário, false.

Contains(PrincipalContext, IdentityType, String)

Origem:

PrincipalCollection.cs

Retorna um valor indicando se o objeto Principal que corresponde ao par identityType/identityValue está na coleção.

public:
 bool Contains(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public bool Contains (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

member this.Contains : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> bool

Public Function Contains (context As PrincipalContext, identityType As IdentityType, identityValue As String) As Boolean

Parâmetros

context

PrincipalContext

O objeto PrincipalContext da entidade de segurança.

identityType

IdentityType

Um IdentityType objeto que especifica o formato de identityValue.

identityValue

String

Uma cadeia de caracteres que identifica a entidade de segurança, no formato especificado por identityType.

Retornos

Boolean

true se um objeto correspondente ao par identityType/identityValue está na coleção; caso contrário, false.

Comentários

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

Exceção	Descrição
MultipleMatchesException	Há várias entidades de segurança que correspondem a esses parâmetros.
ArgumentException	O identityType parâmetro não pode estar vazio.