Where — Klauzula (Visual Basic)

  • Artykuł

Określa warunek filtrowania zapytania.

Składnia

Where condition

generatora

condition
Wymagany. Wyrażenie określające, czy wartości bieżącego elementu w kolekcji znajdują się w kolekcji wyjściowej. Wyrażenie musi mieć wartość Boolean lub odpowiednik Boolean wartości. Jeśli warunek zwróci wartość True, element zostanie uwzględniony w wyniku zapytania. W przeciwnym razie element zostanie wykluczony z wyniku zapytania.

Uwagi

Klauzula Where umożliwia filtrowanie danych zapytań, wybierając tylko elementy spełniające określone kryteria. Elementy, których wartości powodują, że klauzula Where ma zostać obliczona True , są uwzględniane w wyniku zapytania; inne elementy są wykluczone. Wyrażenie, które jest używane w Where klauzuli, musi obliczyć wartość lub Boolean odpowiednik elementu Boolean, takiego jak liczba całkowita, która daje w wyniku, False gdy jego wartość jest równa zero. Można połączyć wiele wyrażeń w klauzuli Where przy użyciu operatorów logicznych, takich jak And, , OrAndAlso, OrElse, Is, i IsNot.

Domyślnie wyrażenia zapytań nie są oceniane do momentu uzyskania do nich dostępu — na przykład gdy są powiązane z danymi lub iterowane w For pętli. W związku z tym klauzula Where nie jest oceniana do momentu uzyskania dostępu do zapytania. Jeśli masz wartości zewnętrzne dla zapytania, które są używane w Where klauzuli , upewnij się, że odpowiednia wartość jest używana w Where klauzuli podczas wykonywania zapytania. Aby uzyskać więcej informacji na temat wykonywania zapytań, zobacz Pisanie pierwszego zapytania LINQ.

Funkcje w Where klauzuli można wywołać, aby wykonać obliczenia lub operację na wartości z bieżącego elementu w kolekcji. Wywołanie funkcji w klauzuli Where może spowodować natychmiastowe wykonanie zapytania, gdy jest zdefiniowane zamiast, gdy jest uzyskiwany dostęp. Aby uzyskać więcej informacji na temat wykonywania zapytań, zobacz Pisanie pierwszego zapytania LINQ.

Przykład 1

Poniższe wyrażenie zapytania używa klauzuli From do deklarowania zmiennej cust zakresu dla każdego Customer obiektu w kolekcji customers . Klauzula Where używa zmiennej zakresu, aby ograniczyć dane wyjściowe do klientów z określonego regionu. Pętla For Each wyświetla nazwę firmy dla każdego klienta w wyniku zapytania.

Sub DisplayCustomersForRegion(ByVal customers As List(Of Customer),
                              ByVal region As String)

    Dim customersForRegion = From cust In customers
                             Where cust.Region = region

    For Each cust In customersForRegion
        Console.WriteLine(cust.CompanyName)
    Next
End Sub

Przykład 2

W poniższym przykładzie użyto And operatorów logicznych i Or w klauzuli Where .

Private Sub DisplayElements()
    Dim elements As List(Of Element) = BuildList()

    ' Get a list of elements that have an atomic number from 12 to 14,
    ' or that have a name that ends in "r".
    Dim subset = From theElement In elements
                 Where (theElement.AtomicNumber >= 12 And theElement.AtomicNumber < 15) _
                 Or theElement.Name.EndsWith("r")
                 Order By theElement.Name

    For Each theElement In subset
        Console.WriteLine(theElement.Name & " " & theElement.AtomicNumber)
    Next

    ' Output:
    '  Aluminum 13
    '  Magnesium 12
    '  Silicon 14
    '  Sulfur 16
End Sub

Private Function BuildList() As List(Of Element)
    Return New List(Of Element) From
        {
            {New Element With {.Name = "Sodium", .AtomicNumber = 11}},
            {New Element With {.Name = "Magnesium", .AtomicNumber = 12}},
            {New Element With {.Name = "Aluminum", .AtomicNumber = 13}},
            {New Element With {.Name = "Silicon", .AtomicNumber = 14}},
            {New Element With {.Name = "Phosphorous", .AtomicNumber = 15}},
            {New Element With {.Name = "Sulfur", .AtomicNumber = 16}}
        }
End Function

Public Class Element
    Public Property Name As String
    Public Property AtomicNumber As Integer
End Class

Zobacz też