Ler em inglês

Compartilhar via


Queryable.Contains Método

Definição

Determina se um IQueryable<T> contém um elemento especificado.

Sobrecargas

Contains<TSource>(IQueryable<TSource>, TSource)

Determina se uma sequência contém um elemento especificado usando o comparador de igualdade padrão.

Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>)

Determina se uma sequência contém um elemento especificado usando um IEqualityComparer<T> especificado.

Contains<TSource>(IQueryable<TSource>, TSource)

Origem:
Queryable.cs
Origem:
Queryable.cs
Origem:
Queryable.cs

Determina se uma sequência contém um elemento especificado usando o comparador de igualdade padrão.

C#
public static bool Contains<TSource> (this System.Linq.IQueryable<TSource> source, TSource item);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IQueryable<TSource>

Um IQueryable<T> no qual item será localizado.

item
TSource

O objeto a ser localizado na sequência.

Retornos

true se a sequência de entrada contiver um elemento que tem o valor especificado; caso contrário, false.

Exceções

source é null.

Exemplos

O exemplo de código a seguir demonstra como usar Contains<TSource>(IQueryable<TSource>, TSource) para determinar se uma sequência contém um elemento específico.

C#
string[] fruits = { "apple", "banana", "mango",
                    "orange", "passionfruit", "grape" };

// The string to search for in the array.
string mango = "mango";

bool hasMango = fruits.AsQueryable().Contains(mango);

Console.WriteLine(
    "The array {0} contain '{1}'.",
    hasMango ? "does" : "does not",
    mango);

// This code produces the following output:
//
// The array does contain 'mango'.

Comentários

O Contains<TSource>(IQueryable<TSource>, TSource) método gera um MethodCallExpression que representa chamar Contains<TSource>(IQueryable<TSource>, TSource) a si mesmo como um método genérico construído. Em seguida, ele passa o MethodCallExpression para o Execute<TResult>(Expression) método do IQueryProvider representado pela Provider propriedade do source parâmetro .

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Contains<TSource>(IQueryable<TSource>, TSource) depende da implementação do tipo do source parâmetro. O comportamento esperado é que ele determina se source contém item.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>)

Origem:
Queryable.cs
Origem:
Queryable.cs
Origem:
Queryable.cs

Determina se uma sequência contém um elemento especificado usando um IEqualityComparer<T> especificado.

C#
public static bool Contains<TSource> (this System.Linq.IQueryable<TSource> source, TSource item, System.Collections.Generic.IEqualityComparer<TSource> comparer);
C#
public static bool Contains<TSource> (this System.Linq.IQueryable<TSource> source, TSource item, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IQueryable<TSource>

Um IQueryable<T> no qual item será localizado.

item
TSource

O objeto a ser localizado na sequência.

comparer
IEqualityComparer<TSource>

Um IEqualityComparer<T> para comparar valores.

Retornos

true se a sequência de entrada contiver um elemento que tem o valor especificado; caso contrário, false.

Exceções

source é null.

Comentários

O Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>) método gera um MethodCallExpression que representa chamar Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>) a si mesmo como um método genérico construído. Em seguida, ele passa o MethodCallExpression para o Execute<TResult>(Expression) método do IQueryProvider representado pela Provider propriedade do source parâmetro .

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>) depende da implementação do tipo do source parâmetro. O comportamento esperado é que ele determina se source contém item usando comparer para comparar valores.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0