Interfejsy IEnumerable i IEnumerator
Aby rozpocząć badanie procesu wdrażania istniejących interfejsów .NET, najpierw przyjrzyjmy się roli IEnumerable i IEnumerator. Przypomnij sobie, że C # obsługuje słowo kluczowe o nazwie foreach, które pozwala iterować po zawartości dowolnego typu tablicy:
// Iterate over an array of items.
int[] myArrayOfInts = {10, 20, 30, 40};
foreach(int i in myArrayOfInts)
{
Console.WriteLine(i);
}
Chociaż może się wydawać, że tylko typy tablic mogą korzystać z tego konstruktu, prawda jest taka, że każdy typ obsługujący metodę o nazwie GetEnumerator () może zostać oceniony przez konstrukcję foreach. Aby to zilustrować, podążaj za mną!
Załóżmy, że mamy klasę Garaż:
// Garage contains a set of Car objects.
public class Garage
{
private Car[] carArray = new Car[4];
// Fill with some Car objects upon startup.
public Garage()
{
carArray[0] = new Car("Rusty", 30);
carArray[1] = new Car("Clunker", 55);
carArray[2] = new Car("Zippy", 30);
carArray[3] = new Car("Fred", 30);
}
}
Idealnie byłoby iterować podelementy obiektu Garage za pomocą konstrukcji foreach, podobnie jak tablica wartości danych:
// This seems reasonable ...
public class Program
{
static void Main(string[] args)
{
Console.WriteLine("***** Fun with IEnumerable / IEnumerator *****\n");
Garage carLot = new Garage();
// Hand over each car in the collection?
foreach (Car c in carLot)
{
Console.WriteLine("{0} is going {1} MPH",
c.PetName, c.CurrentSpeed);
}
Console.ReadLine();
}
}
Niestety kompilator informuje, że klasa Garage nie implementuje metody o nazwie GetEnumerator (). Ta metoda jest sformalizowana przez interfejs IEnumerable, który znajduje się w przestrzeni nazw System.Collections. Klasy lub struktury, które obsługują to zachowanie, reklamują, że są w stanie udostępnić wywołującym zawarte elementy podrzędne (w tym przykładzie samo słowo kluczowe foreach). Oto definicja tego standardowego interfejsu .NET:
// This interface informs the caller
// that the object's subitems can be enumerated.
public interface IEnumerable
{
IEnumerator GetEnumerator();
}
Jak widać, metoda GetEnumerator () zwraca odwołanie do jeszcze innego interfejsu o nazwie System.Collections.IEnumerator. Ten interfejs zapewnia infrastrukturę umożliwiającą rozmówcy przechodzenie przez wewnętrzne obiekty zawarte w kontenerze kompatybilnym z IEnumerable:
// This interface allows the caller to
// obtain a container's subitems.
public interface IEnumerator
{
bool MoveNext (); // Advance the internal position of the cursor.
object Current { get;} // Get the current item (read-only property).
void Reset (); // Reset the cursor before the first member.
}
Jeśli chcesz zaktualizować typ garażu, aby obsługiwał te interfejsy, możesz przejść długą drogę i zaimplementować każdą metodę ręcznie. Chociaż z pewnością masz swobodę dostarczania niestandardowych wersji GetEnumerator (), MoveNext (), Current i Reset (), istnieje prostszy sposób. Ponieważ typ System.Array (jak również wiele innych klas kolekcji) już implementuje IEnumerable i IEnumerator, możesz po prostu delegować żądanie do System.Array w następujący sposób:
using System.Collections;
...
public class Garage : IEnumerable
{
// System.Array already implements IEnumerator!
private Car[] carArray = new Car[4];
public Garage()
{
carArray[0] = new Car("FeeFee", 200);
carArray[1] = new Car("Clunker", 90);
carArray[2] = new Car("Zippy", 30);
carArray[3] = new Car("Fred", 30);
}
public IEnumerator GetEnumerator()
{
// Return the array object's IEnumerator.
return carArray.GetEnumerator();
}
}
Po zaktualizowaniu typu garażu możesz bezpiecznie używać go w konstrukcji Cach foreach. Ponadto, biorąc pod uwagę, że metoda GetEnumerator () została zdefiniowana publicznie, użytkownik obiektu może również wchodzić w interakcje z typem IEnumerator:
// Manually work with IEnumerator.
IEnumerator i = carLot.GetEnumerator();
i.MoveNext();
Car myCar = (Car)i.Current;
Console.WriteLine("{0} is going {1} MPH", myCar.PetName, myCar.CurrentSpeed);
Jeśli jednak wolisz ukryć funkcjonalność IEnumerable na poziomie obiektu, po prostu skorzystaj z jawnej implementacji interfejsu:
IEnumerator IEnumerable.GetEnumerator()
{
// Return the array object's IEnumerator.
return carArray.GetEnumerator();
}
W ten sposób przypadkowy użytkownik obiektu nie znajdzie metody GarEnumerator () Garage, podczas gdy konstrukcja foreach uzyska interfejs w tle, gdy będzie to konieczne.
Na podstawie Pro C # 5.0 i .NET 4.5 Framework
