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<T>, ou un type dérivé tel que IQueryable<T>. 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<T> 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.

Voir aussi

Concepts

Expressions de requête LINQ (Guide de programmation C#)

Historique des modifications

Date	Historique	Motif
Juillet 2010	QueryMethod2 a été ajouté à l'exemple. Les commentaires explicatifs ont été améliorés.	Commentaires client.