where 句 (C# リファレンス)

[アーティクル]
08/09/2011

where 句はクエリ式で使用され、クエリ式でデータソースのどの要素が返されるようにするかを指定します。各ソース要素 (範囲変数で参照される) にブール条件 (述語) を適用し、指定した条件に該当するものを返します。単一のクエリ式に複数の where 句を含めることができ、単一の句に複数の述語部分式を含めることができます。

使用例

次の例の where 句は、5 未満の数値以外のすべての数値をフィルターで除外します。 where 句を削除すると、データソースのすべての数値が返されます。式 num < 5 が各要素に適用される述語です。

class WhereSample
{
    static void Main()
    {   
        // Simple data source. Arrays support IEnumerable<T>.
        int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };

        // Simple query with one predicate in where clause.
        var queryLowNums =
            from num in numbers
            where num < 5
            select num;

        // Execute the query.
        foreach (var s in queryLowNums)
        {
            Console.Write(s.ToString() + " ");
        }
    }
}
//Output: 4 1 3 2 0

単一の where 句の中で、&& 演算子と || 演算子を使用することにより、述語を必要な数だけ指定できます。次の例のクエリは、5 未満の偶数だけを選択するために 2 つの述語を指定しています。

class WhereSample2
{
    static void Main()
    {   
        // Data source.
        int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };

        // Create the query with two predicates in where clause.
        var queryLowNums2 =
            from num in numbers
            where num < 5 && num % 2 == 0
            select num;

        // Execute the query
        foreach (var s in queryLowNums2)
        {
            Console.Write(s.ToString() + " ");
        }            
    }
}
// Output: 4 2 0

where 句には、ブール値を返すメソッドを 1 つ以上含めることができます。次の例の where 句は、範囲変数の現在の値が偶数であるか奇数であるかを判断するためにメソッドを使用しています。

class WhereSample3
{       
    static void Main()
    {
        // Data source
        int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 };

        // Create the query with a method call in the where clause.
        // Note: This won't work in LINQ to SQL unless you have a
        // stored procedure that is mapped to a method by this name.
        var queryEvenNums =
            from num in numbers
            where IsEven(num)
            select num;

         // Execute the query.
        foreach (var s in queryEvenNums)
        {
            Console.Write(s.ToString() + " ");
        }
    }

    // Method may be instance method or static method.
    static bool IsEven(int i)
    {
        return i % 2 == 0;
    }    
}
//Output: 4 8 6 2 0