Queryable.Contains 方法

定義

命名空間:

System.Linq

組件:

System.Linq.Queryable.dll

組件:

System.Core.dll

組件:

netstandard.dll

判斷 IQueryable<T> 是否包含指定的項目。

多載

Contains<TSource>(IQueryable<TSource>, TSource)	使用預設的相等比較子 (Comparer) 來判斷序列是否包含指定的項目。
Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>)	使用指定的 IEqualityComparer<T> 來判斷序列是否包含指定的項目。

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

使用預設的相等比較子 (Comparer) 來判斷序列是否包含指定的項目。

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

類型參數

TSource

source 項目的類型。

參數

source

IQueryable<TSource>

要在其中尋找 item 的 IQueryable<T>。

item

TSource

要在序列中尋找的物件。

傳回

Boolean

如果輸入序列包含具有指定值的項目，則為 true，否則為 false。

例外狀況

ArgumentNullException

source 為 null。

範例

下列程式碼範例示範如何使用 Contains<TSource>(IQueryable<TSource>, TSource) 來判斷序列是否包含特定元素。

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

備註

方法 Contains<TSource>(IQueryable<TSource>, TSource) 會產生 ， MethodCallExpression 表示 Contains<TSource>(IQueryable<TSource>, TSource) 呼叫本身為建構的泛型方法。 然後，它會將 傳遞 MethodCallExpression 至 Execute<TResult>(Expression) 參數的 屬性所 Provider 表示的 source 方法 IQueryProvider 。

執行表示呼叫 Contains<TSource>(IQueryable<TSource>, TSource) 的運算式樹狀結構所產生的查詢行為，取決於參數類型的 source 實作。 預期的行為是它會判斷是否 source 包含 item 。

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

使用指定的 IEqualityComparer<T> 來判斷序列是否包含指定的項目。

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

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

類型參數

TSource

source 項目的類型。

參數

source

IQueryable<TSource>

要在其中尋找 item 的 IQueryable<T>。

item

TSource

要在序列中尋找的物件。

comparer

IEqualityComparer<TSource>

用來比較值的 IEqualityComparer<T>。

傳回

Boolean

如果輸入序列包含具有指定值的項目，則為 true，否則為 false。

例外狀況

ArgumentNullException

source 為 null。

備註

方法 Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>) 會產生 ， MethodCallExpression 表示 Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>) 呼叫本身為建構的泛型方法。 然後，它會將 傳遞 MethodCallExpression 至 Execute<TResult>(Expression) 參數的 屬性所 Provider 表示的 source 方法 IQueryProvider 。

執行表示呼叫 Contains<TSource>(IQueryable<TSource>, TSource, IEqualityComparer<TSource>) 的運算式樹狀結構所產生的查詢行為，取決於參數類型的 source 實作。 預期的行為是它會使用 來比較值來判斷是否 source 包含 item comparer 。