SortedDictionary<TKey,TValue>.GetEnumerator Metode

Definisi

Ruang nama:

System.Collections.Generic

Rakitan:

System.Collections.dll

Sumber:

SortedDictionary.cs

Mengembalikan enumerator yang melakukan iterasi melalui SortedDictionary<TKey,TValue>.

public:
 System::Collections::Generic::SortedDictionary<TKey, TValue>::Enumerator GetEnumerator();

public System.Collections.Generic.SortedDictionary<TKey,TValue>.Enumerator GetEnumerator ();

member this.GetEnumerator : unit -> System.Collections.Generic.SortedDictionary<'Key, 'Value>.Enumerator

Public Function GetEnumerator () As SortedDictionary(Of TKey, TValue).Enumerator

Mengembalikan

SortedDictionary<TKey,TValue>.Enumerator

A SortedDictionary<TKey,TValue>.Enumerator untuk SortedDictionary<TKey,TValue>.

Keterangan

Untuk tujuan enumerasi, setiap item adalah struktur yang KeyValuePair<TKey,TValue> mewakili nilai dan kuncinya.

Pernyataan foreach bahasa C# (for each dalam C++, For Each di Visual Basic) menyembunyikan kompleksitas enumerator. Oleh karena itu, penggunaan foreach disarankan, alih-alih secara langsung memanipulasi enumerator.

Enumerator dapat digunakan untuk membaca data dalam koleksi, tetapi tidak dapat digunakan untuk memodifikasi koleksi yang mendasar.

Kamus dipertahankan dalam urutan yang diurutkan menggunakan pohon internal. Setiap elemen baru diposisikan pada posisi pengurutan yang benar, dan pohon disesuaikan untuk mempertahankan urutan pengurutan setiap kali elemen dihapus. Saat menghitung, urutan pengurutan dipertahankan.

Awalnya, enumerator diposisikan sebelum elemen pertama dalam koleksi. Pada posisi ini, Current properti tidak terdefinisi. Oleh karena itu, Anda harus memanggil MoveNext metode untuk memajukan enumerator ke elemen pertama koleksi sebelum membaca nilai Current.

Properti Current mengembalikan elemen yang sama sampai metode dipanggil MoveNext . MoveNextCurrent diatur 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.

Enumerator tetap valid selama koleksi tetap tidak berubah. Jika perubahan dilakukan pada koleksi, seperti menambahkan, memodifikasi, atau menghapus elemen, enumerator tidak valid dan panggilan berikutnya ke MoveNext atau IEnumerator.Reset melemparkan InvalidOperationException.

Enumerator tidak memiliki akses eksklusif ke koleksi; oleh karena itu, menghitung melalui koleksi secara intrinsik bukan prosedur aman utas. Untuk menjamin keamanan utas selama enumerasi, Anda dapat mengunci koleksi selama seluruh enumerasi. Untuk memungkinkan koleksi diakses oleh beberapa utas untuk membaca dan menulis, Anda harus menerapkan sinkronisasi Anda sendiri.

Implementasi default koleksi di System.Collections.Generic namespace tidak disinkronkan.

Metode ini adalah operasi O(log n), di mana n dihitung.

Lihat juga

• SortedDictionary<TKey,TValue>.Enumerator
• IEnumerator<T>