IEnumeratorContract<C> 介面
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
枚舉一個通用物件集合 IContract 的元素。
generic <typename C>
where C : IContractpublic interface class IEnumeratorContract : System::AddIn::Contract::IContract
public interface IEnumeratorContract<C> : System.AddIn.Contract.IContract where C : IContract
type IEnumeratorContract<'C (requires 'C :> IContract)> = interface
interface IContract
Public Interface IEnumeratorContract(Of C)
Implements IContract
類型參數
- C
要列舉的物件類型。
C必須實作介面。IContract
- 實作
備註
列舉器可用於讀取集合中的資料,但無法用來修改底層集合。
最初,列舉器會被放置在集合中的第一個元素之前。 此時,的 GetCurrent 返回值未定義。 因此,你必須先呼叫 MoveNext ,將列舉器推進到集合的第一個元素,再呼叫 GetCurrent。
GetCurrent 回傳相同的物件直到 MoveNext 被呼叫為止。 MoveNext 將 的 GetCurrent 回傳值設為下一個元素。
若 MoveNext 通過集合的末尾,列舉器會位於集合的最後一個元素之後,並 MoveNext 返回 false。 當列舉器處於此位置時,後續呼叫 MoveNext 也返回 false。 如果最後一次呼叫回 MoveNext 傳 false,則 的 GetCurrent 回傳值未定義。
只要集合未曾改變,列舉器仍然有效。 若對集合進行變更,例如新增、修改或刪除元素,列舉器將無法恢復,其行為也無法定義。
方法
| 名稱 | Description |
|---|---|
| AcquireLifetimeToken() |
規定合約在客戶撤銷合約前仍可取得。 (繼承來源 IContract) |
| GetCurrent() |
在集合中回傳列舉器當前位置的 。IContract |
| GetRemoteHashCode() |
回傳一個雜湊碼。IContract (繼承來源 IContract) |
| MoveNext() |
將列舉器前進至集合的下一個元素。 |
| QueryContract(String) |
回傳由該合約實作的合約。 (繼承來源 IContract) |
| RemoteEquals(IContract) |
表示指定的契約是否等於此。IContract (繼承來源 IContract) |
| RemoteToString() |
回傳當前 IContract的字串表示。 (繼承來源 IContract) |
| Reset() |
將列舉值設定為其初始位置,也就是集合中第一個專案之前。 |
| RevokeLifetimeToken(Int32) |
規定合約不再對客戶開放。 (繼承來源 IContract) |