MatchCollection.IEnumerable<Match>.GetEnumerator Metode

Definisi

Ruang nama:

System.Text.RegularExpressions

Rakitan:

System.Text.RegularExpressions.dll

Sumber:

MatchCollection.cs

Mengembalikan enumerator yang melakukan iterasi melalui koleksi.

 virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Match ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Match ^>::GetEnumerator;

System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match> IEnumerable<Match>.GetEnumerator ();

abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>

Function GetEnumerator () As IEnumerator(Of Match) Implements IEnumerable(Of Match).GetEnumerator

Mengembalikan

IEnumerator<Match>

Enumerator yang dapat digunakan untuk melakukan iterasi melalui koleksi.

Penerapan

GetEnumerator()

Pengecualian

NotSupportedException

Koleksi bersifat baca-saja.

Keterangan

yang dikembalikan IEnumerator<T> memberikan kemampuan untuk melakukan iterasi melalui koleksi dengan mengekspos Current properti . Anda dapat menggunakan enumerator untuk membaca data dalam koleksi, tetapi tidak untuk mengubah koleksi. Awalnya, enumerator diposisikan sebelum elemen pertama dalam koleksi. Pada posisi ini, Current tidak terdefinisi. Oleh karena itu, Anda harus memanggil MoveNext metode untuk memajukan enumerator ke elemen pertama koleksi sebelum membaca nilai Current. Current mengembalikan objek yang sama sampai MoveNext dipanggil lagi sebagai MoveNext diatur Current ke elemen berikutnya. Jika MoveNext melewati akhir koleksi, enumerator diposisikan setelah elemen terakhir dalam koleksi dan MoveNext mengembalikan false. Ketika enumerator berada di posisi ini, panggilan berikutnya untuk MoveNext juga mengembalikan false. Jika panggilan terakhir untuk MoveNext dikembalikan false, Current tidak terdefinis. Anda tidak dapat mengatur Current ke elemen pertama koleksi lagi; Anda harus membuat instans enumerator baru sebagai gantinya. Jika perubahan dilakukan pada koleksi, seperti menambahkan, memodifikasi, atau menghapus elemen, perilaku enumerator tidak ditentukan. Enumerator tidak memiliki akses eksklusif ke koleksi sehingga enumerator tetap valid selama koleksi tetap tidak berubah. Jika perubahan dilakukan pada koleksi, seperti menambahkan, memodifikasi, atau menghapus elemen, enumerator tidak valid dan Anda mungkin mendapatkan hasil yang tidak terduga. Selain itu, menghitung koleksi bukanlah prosedur yang aman untuk utas. Untuk menjamin keamanan utas, Anda harus mengunci koleksi selama enumerator atau menerapkan sinkronisasi pada koleksi. Implementasi default koleksi di namespace tidak disinkronkan System.Collections.Generic .