Collection.GetEnumerator 方法

發行項
08/20/2007

傳回對列舉值物件的參考，這個物件是用來逐一搜尋Collection 物件 (Visual Basic)。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Function GetEnumerator As IEnumerator
'用途
Dim instance As Collection
Dim returnValue As IEnumerator

returnValue = instance.GetEnumerator

public IEnumerator GetEnumerator ()

public:
IEnumerator^ GetEnumerator ()

public IEnumerator GetEnumerator ()

public function GetEnumerator () : IEnumerator

傳回值

傳回對列舉值物件的參考，這個物件是用來逐一搜尋Collection 物件 (Visual Basic)。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 GetEnumerator 方法 (Collection 物件)。

For Each...Next 陳述式 (Visual Basic) 會呼叫 GetEnumerator，以取得列舉值物件，支援集合項目的逐一查看。一般而言，使用 For Each...Next 迴圈即可往返於集合或陣列，而不需要明確呼叫 GetEnumerator。

如果您對逐一查看需要比提供的 For Each...Next 陳述式更周密的控制權，您可以使用 GetEnumerator 方法來執行自訂的周遊作業。下列是您可能需要進行這項處理的一些情況。

您可能會想要回到集合的開頭，並再次啟動逐一查看之後，再完成它。
您可能會因為各種理由而想要跳過一或多個項目。
您可能會想要在周遊當中變更集合項目。此時，您必須取得新的列舉值物件，因為之前的物件已經失效。

範例

下列範例將示範如何使用 GetEnumerator 擷取 Collection 物件的所有項目。

Dim customers As New Collection
' Insert code to add elements to the customers collection.
Dim custEnum As IEnumerator = customers.GetEnumerator()
custEnum.Reset()
Dim thisCustomer As Object
While custEnum.MoveNext()
    thisCustomer = custEnum.Current()
    ' Insert code to process this element of the collection.
End While

GetEnumerator 會建構及傳回列舉值物件，此物件可實作 System.Collections 命名空間的 IEnumerator 介面。列舉值物件會公開 Current 屬性以及 MoveNext 和 Reset 方法。如需詳細資訊，請參閱 For Each...Next 陳述式 (Visual Basic)。

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

共用方式為

Collection.GetEnumerator 方法

語法

傳回值

備註

範例

平台

版本資訊

.NET Framework

.NET Compact Framework

請參閱

參考

其他資源

其他資源