IEnumeratorContract<T> Rozhraní
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vytvoří výčet prvků v kolekci IListContract<T> .
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 objektů, které jsou vyjmuty.
- Implementuje
Poznámky
Enumerátory lze použít ke čtení dat v kolekci, ale nelze je použít k úpravě kolekce.
Zpočátku je enumerátor umístěn před prvním prvkem v kolekci. Na této pozici není vrácená hodnota GetCurrent definována. Proto je nutné před voláním GetCurrentmetody volat MoveNext metodu pro přechod enumerátoru na první prvek kolekce.
GetCurrent vrátí stejný objekt, dokud MoveNext není volána. MoveNext nastaví návratové hodnoty GetCurrent na další prvek.
Pokud MoveNext projde konec kolekce, enumerátor se umístí za poslední prvek v kolekci a MoveNext vrátí false
. Když je enumerátor na této pozici, následné volání také MoveNext vrátí false
. Pokud se poslední volání vrátilo MoveNextfalse
, návratová hodnota není GetCurrent definována.
Enumerátor zůstane platný, dokud kolekce zůstane beze změny. Pokud jsou v kolekci provedeny změny, například přidání, úprava nebo odstranění prvků, je enumerátor nenávratně zneplatněna a jeho chování není definováno.
Metody
Dispose() |
Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od IDisposable) |
GetCurrent() |
Vrátí objekt v kolekci na aktuální pozici enumerátoru. |
MoveNext() |
Posune enumerátor na další prvek kolekce. |
Reset() |
Nastaví enumerátor na jeho počáteční pozici, která je před prvním prvkem v kolekci. |