Enumerable.Where Methode

Definition

Namespace:

System.Linq

Assembly:

System.Linq.dll

Filtert eine Sequenz von Werten basierend auf einem Prädikat.

Überlädt

Where<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Filtert eine Sequenz von Werten basierend auf einem Prädikat.
Where<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)	Filtert eine Sequenz von Werten basierend auf einem Prädikat. In der Logik der Prädikatfunktion wird der Index der einzelnen Elemente verwendet.

Where<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Quelle:

Where.cs

Filtert eine Sequenz von Werten basierend auf einem Prädikat.

C#

public static System.Collections.Generic.IEnumerable<TSource> Where<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IEnumerable<TSource>

Ein zu filterndes IEnumerable<T>

predicate

Func<TSource,Boolean>

Eine Funktion, mit der jedes Element auf eine Bedingung überprüft wird.

Gibt zurück

IEnumerable<TSource>

Ein IEnumerable<T>, das Elemente aus der Eingabesequenz enthält, die die Bedingung erfüllen

Ausnahmen

ArgumentNullException

source oder predicate ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, Where<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) wie eine Sequenz gefiltert wird.

C#

List<string> fruits =
    new List<string> { "apple", "passionfruit", "banana", "mango",
                    "orange", "blueberry", "grape", "strawberry" };

IEnumerable<string> query = fruits.Where(fruit => fruit.Length < 6);

foreach (string fruit in query)
{
    Console.WriteLine(fruit);
}
/*
 This code produces the following output:

 apple
 mango
 grape
*/

Hinweise

Diese Methode wird mithilfe der verzögerten Ausführung implementiert. Der Sofortige Rückgabewert ist ein Objekt, das alle Informationen speichert, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt entweder durch direktes Aufrufen der GetEnumerator -Methode oder mithilfe foreach von in C# oder For Each in Visual Basic aufgezählt wird.

In der Abfrageausdrucksyntax wird eine where (C#)- oder Where (Visual Basic)-Klausel in einen Aufruf von Where<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)übersetzt.

Weitere Informationen

• where-Klausel (C#-Referenz)
• Where-Klausel (Visual Basic)

Where<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)

Quelle:

Where.cs

Filtert eine Sequenz von Werten basierend auf einem Prädikat. In der Logik der Prädikatfunktion wird der Index der einzelnen Elemente verwendet.

C#

public static System.Collections.Generic.IEnumerable<TSource> Where<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,bool> predicate);

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IEnumerable<TSource>

Ein zu filterndes IEnumerable<T>

predicate

Func<TSource,Int32,Boolean>

Eine Funktion zum Überprüfen jedes Quellelements auf eine Bedingung. Der zweite Parameter der Funktion stellt den Index des Quellelements dar.

Gibt zurück

IEnumerable<TSource>

Ein IEnumerable<T>, das Elemente aus der Eingabesequenz enthält, die die Bedingung erfüllen

Ausnahmen

ArgumentNullException

source oder predicate ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Where<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) eine Sequenz basierend auf einem Prädikat gefiltert wird, das den Index der einzelnen Elemente umfasst.

C#

int[] numbers = { 0, 30, 20, 15, 90, 85, 40, 75 };

IEnumerable<int> query =
    numbers.Where((number, index) => number <= index * 10);

foreach (int number in query)
{
    Console.WriteLine(number);
}
/*
 This code produces the following output:

 0
 20
 15
 40
*/

Hinweise

Diese Methode wird mithilfe der verzögerten Ausführung implementiert. Der Sofortige Rückgabewert ist ein Objekt, das alle Informationen speichert, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt entweder durch direktes Aufrufen der GetEnumerator -Methode oder mithilfe foreach von in C# oder For Each in Visual Basic aufgezählt wird.

Das erste Argument von predicate stellt das zu testende Element dar. Das zweite Argument stellt den nullbasierten Index des -Elements in sourcedar.