Collection.GetEnumerator Metode

Definisi

Ruang nama:

Microsoft.VisualBasic

Rakitan:

Microsoft.VisualBasic.Core.dll

Sumber:

Collection.vb

Mengembalikan enumerator yang melakukan iterasi melalui koleksi.

public:
 System::Collections::IEnumerator ^ GetEnumerator();

public System.Collections.IEnumerator GetEnumerator ();

member this.GetEnumerator : unit -> System.Collections.IEnumerator

Public Function GetEnumerator () As IEnumerator

Mengembalikan

IEnumerator

Enumerator yang dapat digunakan untuk melakukan iterasi melalui koleksi.

Contoh

Contoh berikut menunjukkan cara menggunakan GetEnumerator untuk mengambil semua elemen Collection objek.

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 membangun dan mengembalikan objek enumerator, yang mengimplementasikan IEnumerator antarmuka System.Collections namespace. Objek enumerator mengekspos Current properti dan MoveNext metode dan Reset . Untuk informasi lebih lanjut, lihat Untuk Setiap...Pernyataan Berikutnya.

Keterangan

Untuk masing-masing... Pernyataan Berikutnya memanggil GetEnumerator untuk mendapatkan objek enumerator untuk mendukung iterasi atas elemen koleksi. Biasanya, Anda menggunakan For Eachperulangan ...Next untuk melintasi koleksi atau array, dan Anda tidak perlu memanggil GetEnumerator secara eksplisit.

Jika Anda membutuhkan kontrol yang lebih dekat atas iterasi daripada For Eachyang disediakan oleh pernyataan ...Next , Anda dapat menggunakan GetEnumerator metode untuk melakukan traversal yang disesuaikan. Berikut ini adalah beberapa kasus di mana Anda mungkin perlu melakukan ini.

• Anda mungkin ingin kembali ke awal koleksi dan memulai perulangan lagi sebelum selesai.

• Anda mungkin ingin melewati satu atau beberapa elemen karena berbagai alasan.

• Anda mungkin perlu mengubah elemen koleksi di tengah traversal. Dalam hal ini Anda harus mendapatkan objek enumerator baru karena yang sebelumnya tidak valid.