Freigeben über


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

Teile

Begriff

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

Select-Klausel (Visual Basic)

From-Klausel (Visual Basic)

Take-Klausel (Visual Basic)

Skip While-Klausel (Visual Basic)

Where-Klausel (Visual Basic)

Konzepte

Einführung in LINQ in Visual Basic

Weitere Ressourcen

Abfragen (Visual Basic)