Collection.GetEnumerator Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
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 Each
perulangan ...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 Each
yang 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.