Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

L’interfaccia IEnumerable non generica

System.Collections.IEnumerable consente di scorrere gli elementi senza specificarne il tipo tramite un parametro generico. Il metodo GetEnumerator() restituisce IEnumerator e foreach legge gli elementi attraverso questo contratto.

Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintassi

public interface IEnumerable
{
    System.Collections.IEnumerator GetEnumerator();
}

System.Collections.IEnumerable è un contratto non generico che consente di scorrere gli elementi. Dichiara un solo metodo: GetEnumerator(), che restituisce System.Collections.IEnumerator. Non espone né il numero di elementi né un indicizzatore.

È importante distinguere la sequenza dal suo enumeratore: IEnumerable fornisce un enumeratore, mentre IEnumerator mantiene la posizione dell’iterazione. MoveNext() passa all’elemento successivo e indica se l’operazione è riuscita; solo allora è possibile leggere Current, di tipo object. Non è valido leggere Current prima del primo avanzamento riuscito o dopo la fine dell’iterazione. Non è necessario che Reset() sia supportato.

System.Collections.Generic.IEnumerable<T> specifica il tipo degli elementi ed eredita da IEnumerable non generica. Quando il tipo è noto, in genere è preferibile la versione generica; quella non generica è utile quando si interagisce con API che richiedono questo contratto. Un tipo esplicito per la variabile in foreach, ad esempio string, richiede una conversione valida per ogni elemento; un elemento incompatibile può causare InvalidCastException.

Nell’esempio, l’array è accessibile tramite IEnumerable, quindi value è di tipo object, anche se gli elementi sono stringhe. foreach gestisce l’avanzamento dell’enumeratore. Tuttavia, l’uso di foreach da solo non dimostra che questa interfaccia sia implementata: C# supporta anche un pattern appropriato GetEnumerator() con MoveNext() e Current.

Esempi

using System;
using System.Collections;

internal static class Program
{
    private static void Main()
    {
        IEnumerable values = new string[] { "Ada", "Lin" };

        foreach (object value in values)
        {
            Console.WriteLine(value);
        }
    }
}

Risultato

Ada
Lin

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti