Compartilhar via


PrincipalCollection.Contains Método

Definição

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
Origem:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Contains (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
member this.Contains : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool
[<System.Security.SecurityCritical>]
member this.Contains : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool
Public Function Contains (computer As ComputerPrincipal) As Boolean

Parâmetros

computer
ComputerPrincipal

Um objeto ComputerPrincipal.

Retornos

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

Atributos

Aplica-se a

Contains(GroupPrincipal)

Origem:
PrincipalCollection.cs
Origem:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Contains (System.DirectoryServices.AccountManagement.GroupPrincipal group);
member this.Contains : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool
[<System.Security.SecurityCritical>]
member this.Contains : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool
Public Function Contains (group As GroupPrincipal) As Boolean

Parâmetros

group
GroupPrincipal

Um objeto GroupPrincipal.

Retornos

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

Atributos

Aplica-se a

Contains(Principal)

Origem:
PrincipalCollection.cs
Origem:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Contains (System.DirectoryServices.AccountManagement.Principal principal);
abstract member Contains : System.DirectoryServices.AccountManagement.Principal -> bool
override this.Contains : System.DirectoryServices.AccountManagement.Principal -> bool
[<System.Security.SecurityCritical>]
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

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

Implementações

Atributos

Aplica-se a

Contains(UserPrincipal)

Origem:
PrincipalCollection.cs
Origem:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Contains (System.DirectoryServices.AccountManagement.UserPrincipal user);
member this.Contains : System.DirectoryServices.AccountManagement.UserPrincipal -> bool
[<System.Security.SecurityCritical>]
member this.Contains : System.DirectoryServices.AccountManagement.UserPrincipal -> bool
Public Function Contains (user As UserPrincipal) As Boolean

Parâmetros

user
UserPrincipal

Um objeto UserPrincipal.

Retornos

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

Atributos

Aplica-se a

Contains(PrincipalContext, IdentityType, String)

Origem:
PrincipalCollection.cs
Origem:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
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
[<System.Security.SecurityCritical>]
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

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

Atributos

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.

Aplica-se a