Queryable.Where Methode

Definition

Filtert eine Sequenz von Werten basierend auf einem Prädikat.Filters a sequence of values based on a predicate.

Überlädt

Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

Filtert eine Sequenz von Werten basierend auf einem Prädikat.Filters a sequence of values based on a predicate.

Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>)

Filtert eine Sequenz von Werten basierend auf einem Prädikat.Filters a sequence of values based on a predicate. In der Logik der Prädikatfunktion wird der Index der einzelnen Elemente verwendet.Each element's index is used in the logic of the predicate function.

Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

Filtert eine Sequenz von Werten basierend auf einem Prädikat.Filters a sequence of values based on a predicate.

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)

Typparameter

TSource

Der Typ der Elemente von source.The type of the elements of source.

Parameter

source
IQueryable<TSource>

Ein zu filterndes IQueryable<T>An IQueryable<T> to filter.

predicate
Expression<Func<TSource,Boolean>>

Eine Funktion, mit der jedes Element auf eine Bedingung überprüft wird.A function to test each element for a condition.

Gibt zurück

IQueryable<TSource>

Ein IQueryable<T> mit Elementen aus der Eingabesequenz, die die von predicate angegebene Bedingung erfüllen.An IQueryable<T> that contains elements from the input sequence that satisfy the condition specified by predicate.

Ausnahmen

source oder predicate ist null.source or predicate is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie verwendet wird, Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) um eine Sequenz zu filtern.The following code example demonstrates how to use Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) to filter a sequence.

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

Hinweise

Diese Methode verfügt über mindestens einen Parameter des Typs, Expression<TDelegate> dessen Typargument einer der- Func<T,TResult> Typen ist.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Für diese Parameter können Sie einen Lambda-Ausdruck übergeben und in einen kompiliert werden Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

Die- Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) Methode generiert einen, der den MethodCallExpression Aufruf von Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) sich selbst als konstruierte generische Methode darstellt.The Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) method generates a MethodCallExpression that represents calling Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) itself as a constructed generic method. Anschließend übergibt Sie MethodCallExpression an die- CreateQuery(Expression) Methode des, das IQueryProvider durch die- Provider Eigenschaft des- source Parameters dargestellt wird.It then passes the MethodCallExpression to the CreateQuery(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Das Abfrage Verhalten, das auftritt, wenn eine Ausdrucks Baumstruktur ausgeführt wird, die den Aufruf von darstellt, Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) hängt von der Implementierung des Typs des source Parameters ab.The query behavior that occurs as a result of executing an expression tree that represents calling Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) depends on the implementation of the type of the source parameter. Das erwartete Verhalten besteht darin, dass die Elemente aus zurückgegeben source werden, die die von angegebene Bedingung erfüllen predicate .The expected behavior is that it returns the elements from source that satisfy the condition specified by predicate.

Gilt für:

Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>)

Filtert eine Sequenz von Werten basierend auf einem Prädikat.Filters a sequence of values based on a predicate. In der Logik der Prädikatfunktion wird der Index der einzelnen Elemente verwendet.Each element's index is used in the logic of the predicate function.

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)

Typparameter

TSource

Der Typ der Elemente von source.The type of the elements of source.

Parameter

source
IQueryable<TSource>

Ein zu filterndes IQueryable<T>An IQueryable<T> to filter.

predicate
Expression<Func<TSource,Int32,Boolean>>

Eine Funktion zum Überprüfen jedes Elements auf eine Bedingung. Der zweite Parameter der Funktion stellt den Index des Elements in der Quellsequenz dar.A function to test each element for a condition; the second parameter of the function represents the index of the element in the source sequence.

Gibt zurück

IQueryable<TSource>

Ein IQueryable<T> mit Elementen aus der Eingabesequenz, die die von predicate angegebene Bedingung erfüllen.An IQueryable<T> that contains elements from the input sequence that satisfy the condition specified by predicate.

Ausnahmen

source oder predicate ist null.source or predicate is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie verwendet wird, Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) um eine Sequenz auf der Grundlage eines Prädikats zu filtern, das den Index der einzelnen Elemente enthält.The following code example demonstrates how to use Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) to filter a sequence based on a predicate that incorporates the index of each element.

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

Hinweise

Diese Methode verfügt über mindestens einen Parameter des Typs, Expression<TDelegate> dessen Typargument einer der- Func<T,TResult> Typen ist.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Für diese Parameter können Sie einen Lambda-Ausdruck übergeben und in einen kompiliert werden Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

Die- Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) Methode generiert einen, der den MethodCallExpression Aufruf von Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) sich selbst als konstruierte generische Methode darstellt.The Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) method generates a MethodCallExpression that represents calling Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) itself as a constructed generic method. Anschließend übergibt Sie MethodCallExpression an die- CreateQuery(Expression) Methode des, das IQueryProvider durch die- Provider Eigenschaft des- source Parameters dargestellt wird.It then passes the MethodCallExpression to the CreateQuery(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Das Abfrage Verhalten, das auftritt, wenn eine Ausdrucks Baumstruktur ausgeführt wird, die den Aufruf von darstellt, Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) hängt von der Implementierung des Typs des source Parameters ab.The query behavior that occurs as a result of executing an expression tree that represents calling Where<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32,Boolean>>) depends on the implementation of the type of the source parameter. Das erwartete Verhalten besteht darin, dass die Elemente aus zurückgegeben source werden, die die von angegebene Bedingung erfüllen predicate .The expected behavior is that it returns the elements from source that satisfy the condition specified by predicate. Der Index jedes Quell Elements wird als zweites Argument für bereitgestellt predicate .The index of each source element is provided as the second argument to predicate.

Gilt für: