Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Itérateurs (C# et Visual Basic)

Un itérateur peut être utilisé pour parcourir les collections telles que les listes et des tableaux.

Une méthode d'itérateur ou un accesseur get effectue une itération au sein d'une collection. Une méthode d'itérateur utilise l'instruction Yield (Visual Basic) ou yield return (C#) pour retourner les éléments un par un. Lorsqu'une instruction Yield ou yield return est atteinte, la position actuelle dans le code est conservée. L'exécution redémarrera à partir de cet emplacement la prochaine fois que l'itérateur est appelé.

Vous consommez un itérateur de code client à l'aide d'une instruction d' For each… next (Visual Basic) ou d' foreach (c) ou à l'aide d'une requête LINQ.

Dans l'exemple suivant, la première itération de la boucle d' For Each ou d' foreach fait continuer l'exécution de la méthode d'itérateur d' SomeNumbers jusqu'à ce que le premier Yield ou l'instruction d' yield return est atteinte. Cette itération retourne une valeur de 3, et la position actuelle dans la méthode d'itérateur est conservée. Dans l'itération suivante de la boucle, l'exécution de la méthode d'itérateur continue à laquelle elle a été arrêté, de nouveau arrêtant lorsqu'elle atteint une instruction d' Yield ou d' yield return . Cette itération retourne une valeur de 5, et la position actuelle dans la méthode d'itérateur est encore conservée. La boucle se termine lorsque la fin de la méthode d'itérateur est atteinte.


static void Main()
{
    foreach (int number in SomeNumbers())
    {
        Console.Write(number.ToString() + " ");
    }
    // Output: 3 5 8
    Console.ReadKey();
}

public static System.Collections.IEnumerable SomeNumbers()
{
    yield return 3;
    yield return 5;
    yield return 8;
}


Le type de retour d'une méthode d'itérateur ou d'un accesseur get peut être IEnumerable, IEnumerable<T>, IEnumerator, ou IEnumerator<T>.

Vous pouvez utiliser une instruction Exit Function ou Return (Visual Basic) ou une instruction yield break (C#) pour terminer l'itération.

Une fonction d'itérateur Visual Basic ou une déclaration get inclut un modificateur iterator .

Les itérateurs ont été introduits dans C# dans Visual Studio 2005, et ont été introduits dans Visual Basic dans Visual Studio 2012.

Dans cette rubrique

L'exemple suivant a une déclaration unique Yield ou yield return qui est à l'intérieur d'une boucle For… next (Visual Basic) ou de pour (C#). Dans Main, chaque itération For Each ou foreach crée un appel à la fonction itérateur, qui avance a la prochaine déclaration Yield ou yield return .


static void Main()
{
    foreach (int number in EvenSequence(5, 18))
    {
        Console.Write(number.ToString() + " ");
    }
    // Output: 6 8 10 12 14 16 18
    Console.ReadKey();
}

public static System.Collections.Generic.IEnumerable<int>
    EvenSequence(int firstNumber, int lastNumber)
{
    // Yield even numbers in the range.
    for (int number = firstNumber; number <= lastNumber; number++)
    {
        if (number % 2 == 0)
        {
            yield return number;
        }
    }
}


Remarque Remarque

Pour obtenir les exemples restants dans la rubrique, ajoutez les instructions importations (Visual Basic) ou les directives d' utilisation (C#) pour System.Collections et les espaces de noms System.Collections.Generic .

Dans l'exemple suivant, la classe DaysOfTheWeek implémente l'interface IEnumerable , qui requiert une méthode GetEnumerator . Le compilateur appelle implicitement la méthode GetEnumerator , qui retourne un IEnumerator.

La méthode GetEnumerator retourne chaque chaîne une par une à l'aide de l'instruction Yield ou yield return . Dans le code de Visual Basic , un modificateur Iterator est dans la déclaration de fonction.


static void Main()
{
    DaysOfTheWeek days = new DaysOfTheWeek();

    foreach (string day in days)
    {
        Console.Write(day + " ");
    }
    // Output: Sun Mon Tue Wed Thu Fri Sat
    Console.ReadKey();
}

public class DaysOfTheWeek : IEnumerable
{
    private string[] days = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" };

    public IEnumerator GetEnumerator()
    {
        for (int index = 0; index < days.Length; index++)
        {
            // Yield each day of the week.
            yield return days[index];
        }
    }
}


l'exemple suivant crée une classe Zoo qui contient une collection d'animaux.

L'instruction For Each ou foreach qui fait référence à l'instance de classe (theZoo) implicitement appelle la méthode GetEnumerator . Les instructions For Each ou foreach qui font référence aux propriétés de Birds et de Mammals utilisent AnimalsForType nommé méthode d'itérateur.


static void Main()
{
    Zoo theZoo = new Zoo();

    theZoo.AddMammal("Whale");
    theZoo.AddMammal("Rhinoceros");
    theZoo.AddBird("Penguin");
    theZoo.AddBird("Warbler");

    foreach (string name in theZoo)
    {
        Console.Write(name + " ");
    }
    Console.WriteLine();
    // Output: Whale Rhinoceros Penguin Warbler

    foreach (string name in theZoo.Birds)
    {
        Console.Write(name + " ");
    }
    Console.WriteLine();
    // Output: Penguin Warbler

    foreach (string name in theZoo.Mammals)
    {
        Console.Write(name + " ");
    }
    Console.WriteLine();
    // Output: Whale Rhinoceros

    Console.ReadKey();
}

public class Zoo : IEnumerable
{
    // Private members.
    private List<Animal> animals = new List<Animal>();

    // Public methods.
    public void AddMammal(string name)
    {
        animals.Add(new Animal { Name = name, Type = Animal.TypeEnum.Mammal });
    }

    public void AddBird(string name)
    {
        animals.Add(new Animal { Name = name, Type = Animal.TypeEnum.Bird });
    }

    public IEnumerator GetEnumerator()
    {
        foreach (Animal theAnimal in animals)
        {
            yield return theAnimal.Name;
        }
    }

    // Public members.
    public IEnumerable Mammals
    {
        get { return AnimalsForType(Animal.TypeEnum.Mammal); }
    }

    public IEnumerable Birds
    {
        get { return AnimalsForType(Animal.TypeEnum.Bird); }
    }

    // Private methods.
    private IEnumerable AnimalsForType(Animal.TypeEnum type)
    {
        foreach (Animal theAnimal in animals)
        {
            if (theAnimal.Type == type)
            {
                yield return theAnimal.Name;
            }
        }
    }

    // Private class.
    private class Animal
    {
        public enum TypeEnum { Bird, Mammal }

        public string Name { get; set; }
        public TypeEnum Type { get; set; }
    }
}


Visual Basic autorise une instruction Yield dans le bloc Try de Try...Catch...Finally, instruction (Visual Basic). Un bloc Try qui a une instruction Yield peut avoir des blocs Catch , et peut avoir un bloc Finally .

Remarque pour C# Remarque pour C#

C# permet une instruction yield return dans le bloc try d'une instruction try-finally . Un bloc try qui a une instruction yield return n'a peut-être pas de blocs catch .

L'exemple suivant Visual Basic inclut Try, Catch, et les blocs Finally dans un itérateur fonctionnent. Le bloc Finally dans la fonction d'itérateur s'éxécute avant la fin de l'itération For Each.


Sub Main()
    For Each number As Integer In Test()
        Console.WriteLine(number)
    Next
    Console.WriteLine("For Each is done.")

    ' Output:
    '  3
    '  4
    '  Something happened. Yields are done.
    '  Finally is called.
    '  For Each is done.
    Console.ReadKey()
End Sub

Private Iterator Function Test() As IEnumerable(Of Integer)
    Try
        Yield 3
        Yield 4
        Throw New Exception("Something happened. Yields are done.")
        Yield 5
        Yield 6
    Catch ex As Exception
        Console.WriteLine(ex.Message)
    Finally
        Console.WriteLine("Finally is called.")
    End Try
End Function


Une instruction Yield ne peut pas être dans un bloc Catch ou un bloc Finally .

Si le corps de la boucle For Each (au lieu de la méthode d'itérateur) lève une exception, un bloc Catch dans la fonction d'itérateur n'est pas exécuté, mais un bloc Finally dans la fonction d'itérateur est exécuté. Un bloc Catch à l'intérieur d'une fonction d'itérateur intercepte uniquement les exceptions qui se produisent à l'intérieur de la fonction d'itérateur.

Dans Visual Basic (mais pas dans C#), une fonction anonyme peut être une fonction d'itérateur. L'exemple suivant illustre ce comportement.


Dim iterateSequence = Iterator Function() _
                      As IEnumerable(Of Integer)
                          Yield 1
                          Yield 2
                      End Function

For Each number As Integer In iterateSequence()
    Console.Write(number & " ")
Next
' Output: 1 2
Console.ReadKey()


L'exemple suivant Visual Basic a une méthode non itérateurs qui valide les arguments. La méthode retourne le résultat d'un itérateur anonyme qui décrit les éléments de la collection.


Sub Main()
    For Each number As Integer In GetSequence(5, 10)
        Console.Write(number & " ")
    Next
    ' Output: 5 6 7 8 9 10
    Console.ReadKey()
End Sub

Public Function GetSequence(ByVal low As Integer, ByVal high As Integer) _
As IEnumerable
    ' Validate the arguments.
    If low < 1 Then
        Throw New ArgumentException("low is too low")
    End If
    If high > 140 Then
        Throw New ArgumentException("high is too high")
    End If

    ' Return an anonymous iterator function.
    Dim iterateSequence = Iterator Function() As IEnumerable
                              For index = low To high
                                  Yield index
                              Next
                          End Function
    Return iterateSequence()
End Function


Si la validation est à la place à l'intérieur de la fonction d'itérateur, la validation ne peut pas être exécutée avant le début de la première itération du corps de la boucle For Each .

Dans l'exemple suivant, la classe générique Stack(Of T) implémente l'interface générique IEnumerable<T>. La méthode Push assigne des valeurs à un tableau de type T. La méthode GetEnumerator retourne des valeurs de tableau à l'aide de l'instruction Yield ou yield return .

En plus de la méthode générique GetEnumerator , la méthode non générique GetEnumerator doit également être implémentée. En effet IEnumerable<T> hérite de IEnumerable. L'implémentation non générique s'en remet à l'implémentation générique.

L'exemple utilise des itérateurs nommés pour prendre en charge différentes façons d' l'itération via la même collection de données. Ces itérateurs nommés sont les propriétés TopToBottom et BottomToTop , et la méthode TopN .

La propriété BottomToTop utilise un itérateur dans un accesseur get . Dans le code de Visual Basic, la déclaration de la propriété inclut le mot-clé Iterator.


static void Main()
{
    Stack<int> theStack = new Stack<int>();

    //  Add items to the stack.
    for (int number = 0; number <= 9; number++)
    {
        theStack.Push(number);
    }

    // Retrieve items from the stack.
    // foreach is allowed because theStack implements
    // IEnumerable<int>.
    foreach (int number in theStack)
    {
        Console.Write("{0} ", number);
    }
    Console.WriteLine();
    // Output: 9 8 7 6 5 4 3 2 1 0

    // foreach is allowed, because theStack.TopToBottom
    // returns IEnumerable(Of Integer).
    foreach (int number in theStack.TopToBottom)
    {
        Console.Write("{0} ", number);
    }
    Console.WriteLine();
    // Output: 9 8 7 6 5 4 3 2 1 0

    foreach (int number in theStack.BottomToTop)
    {
        Console.Write("{0} ", number);
    }
    Console.WriteLine();
    // Output: 0 1 2 3 4 5 6 7 8 9

    foreach (int number in theStack.TopN(7))
    {
        Console.Write("{0} ", number);
    }
    Console.WriteLine();
    // Output: 9 8 7 6 5 4 3

    Console.ReadKey();
}

public class Stack<T> : IEnumerable<T>
{
    private T[] values = new T[100];
    private int top = 0;

    public void Push(T t)
    {
        values[top] = t;
        top++;
    }
    public T Pop()
    {
        top--;
        return values[top];
    }

    // This method implements the GetEnumerator method. It allows
    // an instance of the class to be used in a foreach statement.
    public IEnumerator<T> GetEnumerator()
    {
        for (int index = top - 1; index >= 0; index--)
        {
            yield return values[index];
        }
    }

    IEnumerator IEnumerable.GetEnumerator()
    {
        return GetEnumerator();
    }

    public IEnumerable<T> TopToBottom
    {
        get { return this; }
    }

    public IEnumerable<T> BottomToTop
    {
        get
        {
            for (int index = 0; index <= top - 1; index++)
            {
                yield return values[index];
            }
        }
    }

    public IEnumerable<T> TopN(int itemsFromTop)
    {
        // Return less than itemsFromTop if necessary.
        int startIndex = itemsFromTop >= top ? 0 : top - itemsFromTop;

        for (int index = top - 1; index >= startIndex; index--)
        {
            yield return values[index];
        }
    }

}


Un itérateur peut se produire en tant que méthode ou accesseur get . Un itérateur ne peut pas apparaître dans un événement, un constructeur d'instance, un constructeur statique, ou un destructeur statique.

Une conversion implicite doit exister dans l'expression dans l'instruction Yield (Visual Basic) ou yield return (C#) au type de retour de l'itérateur.

Dans Visual Basic, une méthode d'itérateur ne peut avoir acune paramètre ByRef . En C#, une méthode d'itérateur ne peut pas avoir pas de paramètres ref ou out .

Dans Visual Basic, « Yield » n'est pas un mot réservé et a une signification particulière uniquement lorsqu'il est utilisé dans une méthode d' Iterator ou un accesseur get . En C#, "yield" n'est pas un sens spécial uniquement lorsqu'il est utilisé avant un mot-clé return ou break .

Bien que vous écriviez un itérateur comme une méthode, le compilateur le traduit en une classe imbriquée qui est, en fait, un ordinateur d'état. Cette classe effectue le suivi de la position de l'itérateur tant que la boucle For Each...Next ou foreach continue dans le client.

Pour consulter l'action du compilateur en arrière-plan, utilisez l'outil ILDASM.exe pour afficher le code IL (Intermediate Language) généré pour une méthode d'itérateur.

Lorsque vous créez un itérateur pour votre classe ou struct, vous n'avez pas à implémenter l'ensemble de l'interface IEnumerator. Lorsque le compilateur détecte l'itérateur, il génère automatiquement les méthodes Current, MoveNext et Dispose de l'interface IEnumerator ou IEnumerator<T>.

Pour chaque itération consécutive de la boucle For Each…Next ou foreach (ou de l'appel direct à IEnumerator.MoveNext), le prochain code du corps de l'itérateur recommence apres le précédent Yield ou yield return . Il continue ensuite jusqu'a la prochaine instruction Yield ou yield return jusqu'a la fin du corps de l'itérateur est atteint ou jusqu'a ce que l'on atteint une déclaration Exit Function ou Return (Visual Basic) ou une instruction yield break (C#).

Les itérateurs ne prennent pas en charge la méthode IEnumerator.Reset. Pour effectuer de nouveau à une itération depuis le début, vous devez obtenir un nouvel itérateur.

Pour plus d'informations, consultez Spécification du langage Visual Basic ou Spécification du langage C#.

Les itérateurs vous permettent de maintenir la simplicité d'une boucle For Each lorsque vous devez utiliser du code complexe pour remplir une séquence de liste. Cela peut être utile lorsque vous souhaitez effectuer :

  • Modifiez la séquence de liste après la première itération de la boucle For Each .

  • Éviter de charger complètement une grande liste avant la première itération d'une boucle For Each . Un exemple est une récupération paginée pour charger une série de lignes de table. Un autre exemple est la méthode EnumerateFiles , qui implémente des itérateurs dans le .NET Framework.

  • Encapsulez la construction de la liste dans l'itérateur. Dans la méthode d'itérateur, vous pouvez générer la liste puis affecter chaque résultat dans une boucle.

Les blogs C# suivants fournissent des informations supplémentaires sur l'utilisation des itérateurs.

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft. Tous droits réservés.