IEnumeratorContract<T> Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wylicza elementy w IListContract<T> kolekcji.
generic <typename T>
public interface class IEnumeratorContract : IDisposable
public interface IEnumeratorContract<T> : IDisposable
type IEnumeratorContract<'T> = interface
interface IDisposable
Public Interface IEnumeratorContract(Of T)
Implements IDisposable
Parametry typu
- T
Typ obiektów, które są wyliczane.
- Implementuje
Uwagi
Moduły wyliczania mogą służyć do odczytywania danych w kolekcji, ale nie można ich używać do modyfikowania kolekcji.
Początkowo moduł wyliczający jest umieszczony przed pierwszym elementem w kolekcji. W tej pozycji wartość zwracana jest GetCurrent niezdefiniowana. W związku z tym należy wywołać metodę MoveNext , aby przejść do pierwszego elementu kolekcji przed wywołaniem metody GetCurrent.
GetCurrent zwraca ten sam obiekt do MoveNext momentu wywołania. MoveNext ustawia wartość zwracaną do GetCurrent następnego elementu.
Jeśli MoveNext przejdzie koniec kolekcji, moduł wyliczający jest umieszczony po ostatnim elemecie w kolekcji i MoveNext zwraca wartość false
. Gdy moduł wyliczający znajduje się na tym stanowisku, kolejne wywołania, aby MoveNext również zwrócić false
wartość . Jeśli ostatnie wywołanie zwracane MoveNextfalse
, zwracana wartość jest GetCurrent niezdefiniowana.
Moduł wyliczający zachowuje ważność tak długo, jak długo kolekcja pozostaje niezmieniona. Jeśli w kolekcji zostaną wprowadzone zmiany, takie jak dodanie, zmodyfikowanie czy usunięcie elementów, moduł wyliczający jest nieodwracalnie unieważniany, a jego zachowanie staje się niezdefiniowane.
Metody
Dispose() |
Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych. (Odziedziczone po IDisposable) |
GetCurrent() |
Zwraca obiekt w kolekcji w bieżącej pozycji modułu wyliczającego. |
MoveNext() |
Rozwija moduł wyliczający do następnego elementu kolekcji. |
Reset() |
Ustawia moduł wyliczający na jego początkową pozycję, która znajduje się przed pierwszym elementem w kolekcji. |