Bagikan melalui


Dictionary<TKey,TValue>.Enumerator Struktur

Definisi

Menghitung elemen dari Dictionary<TKey,TValue>.

public: value class Dictionary<TKey, TValue>::Enumerator : System::Collections::Generic::IEnumerator<System::Collections::Generic::KeyValuePair<TKey, TValue>>, System::Collections::IDictionaryEnumerator
public struct Dictionary<TKey,TValue>.Enumerator : System.Collections.Generic.IEnumerator<System.Collections.Generic.KeyValuePair<TKey,TValue>>, System.Collections.IDictionaryEnumerator
[System.Serializable]
public struct Dictionary<TKey,TValue>.Enumerator : System.Collections.Generic.IEnumerator<System.Collections.Generic.KeyValuePair<TKey,TValue>>, System.Collections.IDictionaryEnumerator
type Dictionary<'Key, 'Value>.Enumerator = struct
    interface IEnumerator<KeyValuePair<'Key, 'Value>>
    interface IEnumerator
    interface IDisposable
    interface IDictionaryEnumerator
[<System.Serializable>]
type Dictionary<'Key, 'Value>.Enumerator = struct
    interface IEnumerator<KeyValuePair<'Key, 'Value>>
    interface IDisposable
    interface IDictionaryEnumerator
    interface IEnumerator
[<System.Serializable>]
type Dictionary<'Key, 'Value>.Enumerator = struct
    interface IEnumerator<KeyValuePair<'Key, 'Value>>
    interface IDisposable
    interface IEnumerator
    interface IDictionaryEnumerator
type Dictionary<'Key, 'Value>.Enumerator = struct
    interface IEnumerator<KeyValuePair<'Key, 'Value>>
    interface IDictionaryEnumerator
    interface IEnumerator
    interface IDisposable
Public Structure Dictionary(Of TKey, TValue).Enumerator
Implements IDictionaryEnumerator, IEnumerator(Of KeyValuePair(Of TKey, TValue))

Jenis parameter

TKey
TValue
Warisan
Dictionary<TKey,TValue>.Enumerator
Atribut
Penerapan

Keterangan

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.

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

Current mengembalikan objek yang sama sampai MoveNext dipanggil. MoveNextCurrent mengatur 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 ditentukan. 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 elemen atau mengubah kapasitas, enumerator tidak dapat dipulihkan dan panggilan berikutnya ke MoveNext atau IEnumerator.Reset melempar InvalidOperationException.

Hanya .NET Core 3.0+: Satu-satunya metode bermutasi yang tidak membatalkan enumerator adalah Remove dan Clear.

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 tidak disinkronkan System.Collections.Generic .

Properti

Current

Mendapatkan elemen pada posisi enumerator saat ini.

Metode

Dispose()

Merilis semua sumber daya yang Dictionary<TKey,TValue>.Enumeratordigunakan oleh .

MoveNext()

Memajukan enumerator ke elemen berikutnya dari Dictionary<TKey,TValue>.

Implementasi Antarmuka Eksplisit

IDictionaryEnumerator.Entry

Mendapatkan elemen pada posisi enumerator saat ini.

IDictionaryEnumerator.Key

Mendapatkan kunci elemen pada posisi enumerator saat ini.

IDictionaryEnumerator.Value

Mendapatkan nilai elemen pada posisi enumerator saat ini.

IEnumerator.Current

Mendapatkan elemen pada posisi enumerator saat ini.

IEnumerator.Reset()

Mengatur enumerator ke posisi awalnya, yaitu sebelum elemen pertama dalam koleksi.

Berlaku untuk

Lihat juga