where, clause (Référence C#)
Mise à jour : novembre 2007
La clause where est utilisée dans une expression de requête pour spécifier les éléments de la source de données qui seront retournés dans l'expression de requête. Il applique une condition booléenne (prédicat) à chaque élément source (référencé par la variable de portée) et retourne ceux pour lesquels la condition spécifiée est remplie. Une expression de requête unique peut contenir plusieurs clauses where et une clause unique peuvent contenir plusieurs sous-expressions de prédicat.
Exemple
Dans l'exemple suivant, la clause where élimine par filtrage tous les nombres excepté ceux inférieurs à cinq. Si vous supprimez la clause where, tous les nombres de la source de données seront retournés. L'expression num < 5 est le prédicat qui est appliqué à chaque élément.
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
Dans une clause where unique, vous pouvez spécifier autant de prédicats que nécessaire à l'aide des opérateurs && et ||. Dans l'exemple suivant, la requête spécifie deux prédicats pour sélectionner uniquement les nombres pairs inférieurs à cinq.
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
Une clause where peut contenir une ou plusieurs méthodes qui retournent des valeurs booléennes. Dans l'exemple suivant, la clause where utilise une méthode pour déterminer si la valeur actuelle de la variable de portée est paire ou impaire.
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
Notes
La clause where est un mécanisme de filtrage. Elle peut être placée à presque n'importe quel endroit d'une expression de requête, sauf qu'elle ne peut pas être la première ni la dernière clause. Une clause where peut apparaître avant ou après une clause group selon que vous devez ou non filtrer les éléments de la source avant ou après qu'ils soient regroupés.
Si un prédicat spécifié n'est pas valide pour les éléments de la source de données, une erreur de compilation est générée. C'est l'un des avantages de la vérification de type fort fourni par LINQ.
À la compilation, le mot clé where est converti en un appel à la méthode d'opérateur de requête standard Where.
Voir aussi
Concepts
Expressions de requête LINQ (Guide de programmation C#)