IEnumeratorContract<T> 介面
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
列舉集合中的 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
類型參數
- T
被列舉的物件類型。
- 實作
備註
列舉器可用於讀取集合中的資料,但無法用來修改集合。
最初,列舉器會被放置在集合中的第一個元素之前。 此時,的 GetCurrent 返回值未定義。 因此,你必須先呼叫 MoveNext ,將列舉器推進到集合的第一個元素,再呼叫 GetCurrent。
GetCurrent 回傳相同的物件直到 MoveNext 被呼叫為止。 MoveNext 將 的 GetCurrent 回傳值設為下一個元素。
若 MoveNext 通過集合的末尾,列舉器會位於集合的最後一個元素之後,並 MoveNext 返回 false。 當列舉器處於此位置時,後續呼叫 MoveNext 也返回 false。 如果最後一次呼叫回 MoveNext 傳 false,則 的 GetCurrent 回傳值未定義。
只要集合未曾改變,列舉器仍然有效。 若對集合進行變更,例如新增、修改或刪除元素,列舉器將無法恢復,其行為也無法定義。
方法
| 名稱 | Description |
|---|---|
| Dispose() |
執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。 (繼承來源 IDisposable) |
| GetCurrent() |
回傳集合中物件,位於列舉器目前的位置。 |
| MoveNext() |
將列舉器前進至集合的下一個元素。 |
| Reset() |
將列舉值設定為其初始位置,也就是集合中第一個專案之前。 |