Queryable.Contains Méthode

Définition

Espace de noms:
System.Linq
Assemblys:
System.Core.dll, System.Linq.Queryable.dll
Assembly:
System.Core.dll
Assembly:
netstandard.dll

Détermine si un IQueryable<T> élément contient un élément spécifié.

Surcharges

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

Détermine si une séquence contient un élément spécifié à l’aide d’un IEqualityComparer<T>spécifié.
Contains<TSource>(IQueryable<TSource>, TSource)

Détermine si une séquence contient un élément spécifié à l’aide du comparateur d’égalité par défaut.

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

Détermine si une séquence contient un élément spécifié à l’aide d’un IEqualityComparer<T>spécifié.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static bool Contains(System::Linq::IQueryable<TSource> ^ source, TSource item, System::Collections::Generic::IEqualityComparer<TSource> ^ comparer);
public static bool Contains<TSource>(this System.Linq.IQueryable<TSource> source, TSource item, System.Collections.Generic.IEqualityComparer<TSource> comparer);
static member Contains : System.Linq.IQueryable<'Source> * 'Source * System.Collections.Generic.IEqualityComparer<'Source> -> bool
<Extension()>
Public Function Contains(Of TSource) (source As IQueryable(Of TSource), item As TSource, comparer As IEqualityComparer(Of TSource)) As Boolean

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source
IQueryable<TSource>

Dans IQueryable<T> lequel localiser item.

item
TSource

Objet à localiser dans la séquence.

comparer
IEqualityComparer<TSource>

Une IEqualityComparer<T> pour comparer les valeurs.

Retours

Boolean

true si la séquence d’entrée contient un élément qui a la valeur spécifiée ; sinon, false.

Exceptions

ArgumentNullException

source a la valeur null.

Remarques

La méthode Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>) génère une MethodCallExpression qui représente l’appel de Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>) elle-même en tant que méthode générique construite. Il transmet ensuite la MethodCallExpression à la méthode Execute<TResult>(Expression) de l'IQueryProvider représentée par la propriété Provider du paramètre source.

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel de Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>) dépend de l’implémentation du type du paramètre source. Le comportement attendu est qu’il détermine si source contient item à l’aide comparer de la comparaison des valeurs.

S’applique à

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

Détermine si une séquence contient un élément spécifié à l’aide du comparateur d’égalité par défaut.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static bool Contains(System::Linq::IQueryable<TSource> ^ source, TSource item);
public static bool Contains<TSource>(this System.Linq.IQueryable<TSource> source, TSource item);
static member Contains : System.Linq.IQueryable<'Source> * 'Source -> bool
<Extension()>
Public Function Contains(Of TSource) (source As IQueryable(Of TSource), item As TSource) As Boolean

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source
IQueryable<TSource>

Dans IQueryable<T> lequel localiser item.

item
TSource

Objet à localiser dans la séquence.

Retours

Boolean

true si la séquence d’entrée contient un élément qui a la valeur spécifiée ; sinon, false.

Exceptions

ArgumentNullException

source a la valeur null.

Exemples

L’exemple de code suivant montre comment utiliser Contains<TSource>(IQueryable<TSource>, TSource) pour déterminer si une séquence contient un élément spécifique.

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'.

Dim fruits() As String = {"apple", "banana", "mango", _
                        "orange", "passionfruit", "grape"}

' The string to search for in the array.
Dim mango As String = "mango"

Dim hasMango As Boolean = fruits.AsQueryable().Contains(mango)

MsgBox(String.Format("The array {0} contain '{1}'.", _
        IIf(hasMango, "does", "does not"), mango))

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

Remarques

La méthode Contains<TSource>(IQueryable<TSource>, TSource) génère une MethodCallExpression qui représente l’appel de Contains<TSource>(IQueryable<TSource>, TSource) elle-même en tant que méthode générique construite. Il transmet ensuite la MethodCallExpression à la méthode Execute<TResult>(Expression) de l'IQueryProvider représentée par la propriété Provider du paramètre source.

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel de Contains<TSource>(IQueryable<TSource>, TSource) dépend de l’implémentation du type du paramètre source. Le comportement attendu est qu’il détermine si source contient item.

S’applique à