Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

IEnumerable e IEnumerator non generici in System.Collections

IEnumerable fornisce un enumeratore e IEnumerator tiene traccia della posizione nella sequenza. Un'implementazione esplicita rispetta il contratto non generico senza duplicare la logica di iterazione.

Versione: C# 12 and .NET 8; later runtimes may add compatible features

Sintassi

using System.Collections;
using System.Collections.Generic;

sealed class Sequence<T> : IEnumerable<T>
{
    public IEnumerator<T> GetEnumerator()
    {
        yield break;
    }

    IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}

System.Collections.IEnumerable rappresenta un'origine di elementi. Il suo metodo GetEnumerator() restituisce un System.Collections.IEnumerator che tiene traccia della posizione nella sequenza. L'enumeratore parte prima del primo elemento. Leggi Current solo dopo che MoveNext() ha restituito true e termina l'iterazione quando restituisce false. Reset() serve a ripristinare la posizione iniziale, ma può generare NotSupportedException, come accade con gli iteratori che usano yield. Per ricominciare, ottieni un nuovo enumeratore.

IEnumerable<T> in System.Collections.Generic eredita dall'interfaccia non generica IEnumerable, quindi la classe deve rispettare entrambi i contratti. Esponi un metodo pubblico che restituisce IEnumerator<T> e aggiungi IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Questa implementazione esplicita è accessibile attraverso l'interfaccia non generica. Non è un normale overload: in C# due overload non possono differire solo per il tipo restituito. Entrambe le chiamate usano la stessa logica di iterazione.

IEnumerator<T> eredita da IEnumerator e IDisposable. Il suo Current generico è di tipo T, mentre quello non generico restituisce object. Nell'esempio, leggere il Current non generico effettua il boxing di un int, mentre foreach (int ...) ne effettua l'unboxing. Un iteratore con yield fornisce entrambe le versioni di Current. Se scrivi un enumeratore, puoi implementare esplicitamente il Current non generico.

foreach chiama MoveNext() e legge Current senza usare Reset(). Chiama anche Dispose() se l'enumeratore implementa IDisposable, persino quando esci dal ciclo in anticipo. Se esegui l'iterazione manualmente con IEnumerator, verifica in un blocco finally se l'enumeratore implementa IDisposable e, in tal caso, chiama Dispose(): l'interfaccia non generica non richiede questo metodo.

Esempi

using System;
using System.Collections;
using System.Collections.Generic;

IEnumerable<int> typed = new EvenPair();
IEnumerable untyped = typed;

foreach (int value in typed)
    Console.WriteLine(FormattableString.Invariant($"Generic: {value}"));

foreach (int value in untyped)
    Console.WriteLine(FormattableString.Invariant($"Non-generic: {value}"));

sealed class EvenPair : IEnumerable<int>
{
    public IEnumerator<int> GetEnumerator()
    {
        yield return 2;
        yield return 4;
    }

    IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}

Risultato

Generic: 2
Generic: 4
Non-generic: 2
Non-generic: 4

Entrambe le variabili fanno riferimento allo stesso oggetto. Il secondo ciclo chiama l'implementazione esplicita tramite `IEnumerable` e legge di nuovo `2` e `4`.

Lezioni correlate

  • C# · Lezione 38 · Intermedio · Versione: 2

Fonti