Queryable.Where Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Filtruje posloupnost hodnot na základě predikátu.
Přetížení
Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) |
Filtruje posloupnost hodnot na základě predikátu. |
Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) |
Filtruje posloupnost hodnot na základě predikátu. Index každého prvku se používá v logice predikátové funkce. |
Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)
Filtruje posloupnost hodnot na základě predikátu.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<TSource> ^ Where(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, bool> ^> ^ predicate);
public static System.Linq.IQueryable<TSource> Where<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);
static member Where : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> System.Linq.IQueryable<'Source>
<Extension()>
Public Function Where(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As IQueryable(Of TSource)
Parametry typu
- TSource
Typ prvků source
.
Parametry
- source
- IQueryable<TSource>
Filtr IQueryable<T> .
- predicate
- Expression<Func<TSource,Boolean>>
Funkce pro otestování jednotlivých prvků pro podmínku.
Návraty
- IQueryable<TSource>
Prvek IQueryable<T> , který obsahuje prvky ze vstupní sekvence, které splňují podmínku určenou predicate
.
Výjimky
source
nebo predicate
je null
.
Příklady
Následující příklad kódu ukazuje, jak použít Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) k filtrování sekvence.
List<string> fruits =
new List<string> { "apple", "passionfruit", "banana", "mango",
"orange", "blueberry", "grape", "strawberry" };
// Get all strings whose length is less than 6.
IEnumerable<string> query =
fruits.AsQueryable().Where(fruit => fruit.Length < 6);
foreach (string fruit in query)
Console.WriteLine(fruit);
/*
This code produces the following output:
apple
mango
grape
*/
Dim fruits As New List(Of String)(New String() _
{"apple", "passionfruit", "banana", "mango", _
"orange", "blueberry", "grape", "strawberry"})
' Get all strings whose length is less than 6.
Dim query = fruits.AsQueryable().Where(Function(fruit) fruit.Length < 6)
' Display the results.
Dim output As New System.Text.StringBuilder
For Each fruit As String In query
output.AppendLine(fruit)
Next
MsgBox(output.ToString())
' This code produces the following output:
' apple
' mango
' grape
Poznámky
Tato metoda má alespoň jeden parametr typu Expression<TDelegate> , jehož argument typu je jedním z Func<T,TResult> typů. Pro tyto parametry můžete předat výraz lambda a bude zkompilován do Expression<TDelegate>.
Tato Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) metoda vygeneruje MethodCallExpression volání Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) jako vytvořenou obecnou metodu. Pak předá MethodCallExpression metodu IQueryProvider CreateQuery(Expression) reprezentované Provider vlastností parametrusource
.
Chování dotazu, ke kterému dochází v důsledku spuštění stromu výrazu, který představuje volání Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) , závisí na implementaci typu parametru source
. Očekávané chování je, že vrací prvky, které source
splňují podmínku určenou predicate
.
Platí pro
Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>)
Filtruje posloupnost hodnot na základě predikátu. Index každého prvku se používá v logice predikátové funkce.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Linq::IQueryable<TSource> ^ Where(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, int, bool> ^> ^ predicate);
public static System.Linq.IQueryable<TSource> Where<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,int,bool>> predicate);
static member Where : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, int, bool>> -> System.Linq.IQueryable<'Source>
<Extension()>
Public Function Where(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Integer, Boolean))) As IQueryable(Of TSource)
Parametry typu
- TSource
Typ prvků source
.
Parametry
- source
- IQueryable<TSource>
Filtr IQueryable<T> .
- predicate
- Expression<Func<TSource,Int32,Boolean>>
Funkce k otestování každého prvku pro podmínku; druhý parametr funkce představuje index prvku ve zdrojové sekvenci.
Návraty
- IQueryable<TSource>
Prvek IQueryable<T> , který obsahuje prvky ze vstupní sekvence, které splňují podmínku určenou predicate
.
Výjimky
source
nebo predicate
je null
.
Příklady
Následující příklad kódu ukazuje, jak použít Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) k filtrování sekvence na základě predikátu, který zahrnuje index každého prvku.
int[] numbers = { 0, 30, 20, 15, 90, 85, 40, 75 };
// Get all the numbers that are less than or equal to
// the product of their index in the array and 10.
IEnumerable<int> query =
numbers.AsQueryable()
.Where((number, index) => number <= index * 10);
foreach (int number in query)
Console.WriteLine(number);
/*
This code produces the following output:
0
20
15
40
*/
Dim numbers() As Integer = {0, 30, 20, 15, 90, 85, 40, 75}
' Get all the numbers that are less than or equal to
' the product of their index in the array and 10.
Dim query = numbers.AsQueryable() _
.Where(Function(number, index) number <= index * 10)
' Display the results.
Dim output As New System.Text.StringBuilder
For Each number As Integer In query
output.AppendLine(number)
Next
MsgBox(output.ToString())
' This code produces the following output:
' 0
' 20
' 15
' 40
Poznámky
Tato metoda má alespoň jeden parametr typu Expression<TDelegate> , jehož argument typu je jedním z Func<T,TResult> typů. Pro tyto parametry můžete předat výraz lambda a bude zkompilován do Expression<TDelegate>.
Tato Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) metoda vygeneruje MethodCallExpression volání Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) jako vytvořenou obecnou metodu. Pak předá MethodCallExpression metodu IQueryProvider CreateQuery(Expression) reprezentované Provider vlastností parametrusource
.
Chování dotazu, ke kterému dochází v důsledku spuštění stromu výrazu, který představuje volání Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) , závisí na implementaci typu parametru source
. Očekávané chování je, že vrací prvky, které source
splňují podmínku určenou predicate
. Index každého zdrojového prvku je poskytován jako druhý argument pro predicate
.