Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

A interface IEnumerable não genérica

System.Collections.IEnumerable permite percorrer elementos sem especificar o respetivo tipo através de um parâmetro genérico. O método GetEnumerator() devolve IEnumerator, e foreach lê os elementos através deste contrato.

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

Sintaxe

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

System.Collections.IEnumerable é um contrato não genérico para percorrer elementos. Declara um método: GetEnumerator(), que devolve System.Collections.IEnumerator. Não disponibiliza uma contagem de elementos nem um indexador.

É importante distinguir a sequência do respetivo enumerador: IEnumerable disponibiliza um enumerador, enquanto IEnumerator mantém a posição da iteração. MoveNext() avança para o elemento seguinte e indica se a operação foi bem-sucedida; só então é possível ler Current, do tipo object. Não é válido ler Current antes do primeiro avanço bem-sucedido nem depois de a iteração terminar. Não é obrigatório suportar Reset().

System.Collections.Generic.IEnumerable<T> especifica o tipo dos elementos e herda de IEnumerable não genérica. Quando o tipo é conhecido, prefira geralmente a versão genérica; a versão não genérica é útil ao interagir com APIs que exigem este contrato. Um tipo explícito para a variável em foreach, como string, exige uma conversão válida para cada elemento; um elemento incompatível pode causar InvalidCastException.

No exemplo, o array é acedido através de IEnumerable, pelo que value é do tipo object, apesar de os elementos serem cadeias de caracteres. foreach trata do avanço do enumerador. No entanto, a utilização de foreach, por si só, não prova que esta interface esteja implementada: C# também suporta um padrão adequado GetEnumerator() com MoveNext() e Current.

Exemplos

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);
        }
    }
}

Resultado

Ada
Lin

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes