Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Enumerable.TakeWhile<TSource>-Methode: (IEnumerable<TSource>, Func<TSource, Int32, Boolean>)

 

Veröffentlicht: Oktober 2016

Gibt Elemente aus einer Sequenz zurück, solange eine angegebene Bedingung true ist. In der Logik der Prädikatfunktion wird der Index des Elements verwendet.

Namespace:   System.Linq
Assembly:  System.Core (in System.Core.dll)

public static IEnumerable<TSource> TakeWhile<TSource>(
	this IEnumerable<TSource> source,
	Func<TSource, int, bool> predicate
)

Parameter

source
Type: System.Collections.Generic.IEnumerable<TSource>

Die Sequenz, aus der Elemente zurückgegeben werden sollen.

predicate
Type: System.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.

Rückgabewert

Type: System.Collections.Generic.IEnumerable<TSource>

Eine IEnumerable<T> die Elemente aus der Eingabesequenz, die vor dem Element auftreten, bei dem die Überprüfung nicht mehr erfolgreich, enthält.

Typparameter

TSource

Der Typ der Elemente von source.

Exception Condition
ArgumentNullException

source oder predicate ist null.

Diese Methode wird mit verzögerter Ausführung implementiert. Der sofortige Rückgabewert ist ein Objekt, das alle Informationen gespeichert hat, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird nicht ausgeführt, bis das Objekt aufgelistet wird, entweder durch Aufrufen der GetEnumerator -Methode direkt oder mithilfe von foreach in Visual C# oder For Each in Visual Basic.

Die TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource, Int32, Boolean>) -Methode überprüft jedes Element von source mit predicate und gibt das Element, wenn das Ergebnis ist true. Enumeration wird beendet, wenn die Prädikatfunktion zurückgegeben false für ein Element oder source keine Elemente mehr enthält.

Das erste Argument der predicate darstellt, das zu testende Element. Das zweite Argument stellt den nullbasierten Index des Elements in source.

Die TakeWhile und SkipWhile -Methode sind funktionale Komplemente. Ein Sequenz- coll und eine reine Funktion p, Verketten der Ergebnisse von coll.TakeWhile(p) und coll.SkipWhile(p) ergibt die gleiche Sequenz wie coll.

In Visual Basic Abfragen Ausdruckssyntax, ein Take While -Klausel übersetzt in einen Aufruf von TakeWhile.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource, Int32, Boolean>) auf Elemente ab dem Anfang einer Sequenz zurückgegeben werden, solange eine Bedingung, der Index des Elements verwendet, auf "true" festgelegt ist.

string[] fruits = { "apple", "passionfruit", "banana", "mango", 
                      "orange", "blueberry", "grape", "strawberry" };

IEnumerable<string> query =
    fruits.TakeWhile((fruit, index) => fruit.Length >= index);

foreach (string fruit in query)
{
    Console.WriteLine(fruit);
}

/*
 This code produces the following output:

 apple
 passionfruit
 banana
 mango
 orange
 blueberry
*/

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 3.5
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: