Freigeben über


Take While-Klausel (Visual Basic)

Aktualisiert: November 2007

Gibt Elemente in einer Auflistung zurück, solange eine angegebene Bedingung true ist, und überspringt dann die übrigen Elemente.

Take While expression

Bestandteile

  • 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

Konzepte

Einführung in LINQ in Visual Basic

Referenz

Select-Klausel (Visual Basic)

From-Klausel (Visual Basic)

Take-Klausel (Visual Basic)

Skip While-Klausel (Visual Basic)

Where-Klausel (Visual Basic)

Weitere Ressourcen

Abfragen (Visual Basic)