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.