Comment : retourner une requête à partir d'une méthode (Guide de programmation C#)
Cet exemple indique comment retourner une requête à partir d'une méthode comme valeur de retour et en tant que paramètre out.
Toute requête doit avoir un type de IEnumerable ou IEnumerable, ou un type dérivé tel que IQueryable. Par conséquent, toute valeur de retour ou paramètre out d'une méthode qui retourne une requête doit également avoir ce type. Si une méthode matérialise une requête dans un type List concret ou un type Array, il est considéré comme retournant les résultats de la requête au lieu de la requête elle-même. Une variable de requête retournée à partir d'une méthode peut néanmoins être composée ou modifiée.
Exemple
Dans l'exemple suivant, la première méthode retourne une requête comme valeur de retour et la seconde méthode retourne une requête comme paramètre out . Notez que dans les deux cas, c'est une requête qui est retournée, et non des résultats de requête.
class MQ
{
// QueryMethhod1 returns a query as its value.
IEnumerable<string> QueryMethod1(ref int[] ints)
{
var intsToStrings = from i in ints
where i > 4
select i.ToString();
return intsToStrings;
}
// QueryMethod2 returns a query as the value of parameter returnQ.
void QueryMethod2(ref int[] ints, out IEnumerable<string> returnQ)
{
var intsToStrings = from i in ints
where i < 4
select i.ToString();
returnQ = intsToStrings;
}
static void Main()
{
MQ app = new MQ();
int[] nums = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };
// QueryMethod1 returns a query as the value of the method.
var myQuery1 = app.QueryMethod1(ref nums);
// Query myQuery1 is executed in the following foreach loop.
Console.WriteLine("Results of executing myQuery1:");
// Rest the mouse pointer over myQuery1 to see its type.
foreach (string s in myQuery1)
{
Console.WriteLine(s);
}
// You also can execute the query returned from QueryMethod1
// directly, without using myQuery1.
Console.WriteLine("\nResults of executing myQuery1 directly:");
// Rest the mouse pointer over the call to QueryMethod1 to see its
// return type.
foreach (string s in app.QueryMethod1(ref nums))
{
Console.WriteLine(s);
}
IEnumerable<string> myQuery2;
// QueryMethod2 returns a query as the value of its out parameter.
app.QueryMethod2(ref nums, out myQuery2);
// Execute the returned query.
Console.WriteLine("\nResults of executing myQuery2:");
foreach (string s in myQuery2)
{
Console.WriteLine(s);
}
// You can modify a query by using query composition. A saved query
// is nested inside a new query definition that revises the results
// of the first query.
myQuery1 = from item in myQuery1
orderby item descending
select item;
// Execute the modified query.
Console.WriteLine("\nResults of executing modified myQuery1:");
foreach (string s in myQuery1)
{
Console.WriteLine(s);
}
// Keep console window open in debug mode.
Console.WriteLine("Press any key to exit.");
Console.ReadKey();
}
}
Compilation du code
Créez un projet Visual Studio qui cible la version 3.5 ou une version ultérieure de .NET Framework. Par défaut, le projet possède une référence à System.Core.dll et une directive using pour l'espace de noms System.Linq.
Remplacez la classe par le code dans l'exemple.
Appuyez sur F5 pour compiler et exécuter le programme.
Appuyez sur une touche pour quitter la fenêtre de console.