Take While-Klausel (Visual Basic)
Gibt Elemente in einer Auflistung zurück, solange eine angegebene Bedingung true ist, und überspringt dann die übrigen Elemente.
Take While expression
Bestandteile
Ausdruck |
Definition |
expression |
Erforderlich. Ein Ausdruck, der eine Bedingung darstellt, auf die Elemente getestet werden sollen. Der Ausdruck muss einen Boolean-Wert oder eine funktionale Entsprechung wie beispielsweise einen Integer-Wert zurückgeben, um als Boolean ausgewertet zu werden. |
Hinweise
Mit der Take While-Klausel werden Elemente vom Anfang eines Abfrageergebnisses bis zu der Stelle eingeschlossen, an der der vorgegebene expression den Wert false zurückgibt. Sobald von expression der Wert false zurückgegeben wird, werden alle übrigen Elemente von der Abfrage nicht mehr berücksichtigt. Für die übrigen Ergebnisse wird expression ignoriert.
Die Take While-Klausel unterscheidet sich von der Where-Klausel insofern, als mit der Where-Klausel alle Elemente einer Abfrage, die eine bestimmte Bedingung erfüllen, eingeschlossen werden können. Mit der Take While-Klausel werden Elemente nur so lange eingeschlossen, bis die Bedingung zum ersten Mal nicht erfüllt wird. Die Take While-Klausel ist besonders hilfreich, wenn Sie mit einem sortierten Abfrageergebnis arbeiten.
Beispiel
Im folgenden Codebeispiel werden mit der Take While-Klausel Ergebnisse abgerufen, bis der erste Kunde ohne Bestellungen gefunden wird.
Public Sub TakeWhileSample()
Dim customers = GetCustomerList()
' Return customers until the first customer with no orders is found.
Dim customersWithOrders = From cust In customers
Order By cust.Orders.Count Descending
Take While HasOrders(cust)
For Each cust In customersWithOrders
Console.WriteLine(cust.CompanyName & " (" & cust.Orders.Length & ")")
Next
End Sub
Public Function HasOrders(ByVal cust As Customer) As Boolean
If cust.Orders.Length > 0 Then Return True
Return False
End Function
Siehe auch
Referenz
Skip While-Klausel (Visual Basic)
Konzepte
Einführung in LINQ in Visual Basic