Where 句 (Visual Basic)Where Clause (Visual Basic)

クエリのフィルター処理条件を示します。Specifies the filtering condition for a query.

構文Syntax

Where condition  

指定項目Parts

condition
必須です。Required. コレクション内の現在の項目の値が出力コレクションに含まれるかどうかを決定する式。An expression that determines whether the values for the current item in the collection are included in the output collection. 式は、Boolean 値または Boolean 値と等価の値に評価される必要があります。The expression must evaluate to a Boolean value or the equivalent of a Boolean value. 条件が True に評価される場合、要素はクエリ結果に含まれます。それ以外の場合、要素はクエリ結果から除外されます。If the condition evaluates to True, the element is included in the query result; otherwise, the element is excluded from the query result.

RemarksRemarks

Where 句を使用すると、特定の条件を満たす要素のみを選択することで、クエリ データをフィルター処理できます。The Where clause enables you to filter query data by selecting only elements that meet certain criteria. 値が Where 句を True に評価させる要素は、クエリ結果に含まれます。その他の要素は除外されます。Elements whose values cause the Where clause to evaluate to True are included in the query result; other elements are excluded. Where 句で使用される式は、Boolean または Boolean と等価 (値が 0 の場合に False に評価される整数など) に評価される必要があります。The expression that is used in a Where clause must evaluate to a Boolean or the equivalent of a Boolean, such as an Integer that evaluates to False when its value is zero. Where 句では、AndOrAndAlsoOrElseIsIsNot などの論理演算子を使用して、複数の式を組み合わせることができます。You can combine multiple expressions in a Where clause by using logical operators such as And, Or, AndAlso, OrElse, Is, and IsNot.

既定では、クエリ式は、アクセスされるまで評価されません。たとえば、データ バインドされたり、For ループ内で反復処理されたりするときです。By default, query expressions are not evaluated until they are accessed—for example, when they are data-bound or iterated through in a For loop. その結果、Where 句は、クエリがアクセスされるまで評価されません。As a result, the Where clause is not evaluated until the query is accessed. Where 句で使用されているクエリの外部の値がある場合は、クエリの実行時に Where 句で適切な値が使用されていることを確認してください。If you have values external to the query that are used in the Where clause, ensure that the appropriate value is used in the Where clause at the time the query is executed. クエリの実行の詳細については、「初めての LINQ クエリの作成」を参照してください。For more information about query execution, see Writing Your First LINQ Query.

Where 句内で関数を呼び出して、コレクション内の現在の要素の値に対して計算または操作を実行することができます。You can call functions within a Where clause to perform a calculation or operation on a value from the current element in the collection. Where 句で関数を呼び出すと、クエリを、アクセス時ではなく定義された直後に実行することができます。Calling a function in a Where clause can cause the query to be executed immediately when it is defined instead of when it is accessed. クエリの実行の詳細については、「初めての LINQ クエリの作成」を参照してください。For more information about query execution, see Writing Your First LINQ Query.

Example

次のクエリ式では、From 句を使用して、customers コレクション内の各 Customer オブジェクトに対して cust 範囲変数を宣言しています。The following query expression uses a From clause to declare a range variable cust for each Customer object in the customers collection. Where 句では、範囲変数を使用して、指定した地域の顧客に出力を制限します。The Where clause uses the range variable to restrict the output to customers from the specified region. For Each ループによって、クエリ結果に各顧客の会社名を表示します。The For Each loop displays the company name for each customer in the query result.

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

Example

次の例では、Where 句で And および Or 論理演算子を使用しています。The following example uses And and Or logical operators in the Where clause.

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

関連項目See also