DictionaryBase.ICollection.SyncRoot Properti

Definisi

Ruang nama:

System.Collections

Rakitan:

System.Collections.NonGeneric.dll

Sumber:

DictionaryBase.cs

Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke DictionaryBase objek.

property System::Object ^ System::Collections::ICollection::SyncRoot { System::Object ^ get(); };

object System.Collections.ICollection.SyncRoot { get; }

member this.System.Collections.ICollection.SyncRoot : obj

 ReadOnly Property SyncRoot As Object Implements ICollection.SyncRoot

Nilai Properti

Object

Objek yang dapat digunakan untuk menyinkronkan akses ke DictionaryBase objek.

Penerapan

SyncRoot

Contoh

Contoh kode berikut menunjukkan cara mengunci koleksi menggunakan SyncRoot properti selama seluruh enumerasi.

ICollection^ myCollection = gcnew ShortStringDictionary();
bool lockTaken = false;
try
{
    Monitor::Enter(myCollection->SyncRoot, lockTaken);
    for each (Object^ item in myCollection);
    {
        // Insert your code here.
    }
}
finally
{
    if (lockTaken)
    {
        Monitor::Exit(myCollection->SyncRoot);
    }
}

ICollection myCollection = new ShortStringDictionary();
lock(myCollection.SyncRoot)
{
    foreach (Object item in myCollection)
    {
        // Insert your code here.
    }
}

Dim myCollection As ICollection = New ShortStringDictionary()
SyncLock myCollection.SyncRoot
    For Each item In myCollection
        ' Insert your code here.
    Next item
End SyncLock

Mengambil nilai properti ini adalah O(1) operasi.

Keterangan

Kelas turunan dapat menyediakan versi kelas yang disinkronkan DictionaryBase sendiri menggunakan SyncRoot properti . Kode sinkronisasi harus melakukan operasi pada SyncRoot properti DictionaryBase objek , bukan langsung pada DictionaryBase objek . Ini memastikan pengoperasian koleksi yang tepat yang berasal dari objek lain. Secara khusus, ia mempertahankan sinkronisasi yang tepat dengan utas lain yang mungkin secara bersamaan memodifikasi DictionaryBase objek.

Menghitung melalui koleksi secara intrinsik bukan prosedur aman utas. Bahkan ketika koleksi disinkronkan, utas lain masih dapat memodifikasi koleksi, yang menyebabkan enumerator melemparkan pengecualian. Untuk menjamin keamanan utas selama enumerasi, Anda dapat mengunci koleksi selama seluruh enumerasi atau menangkap pengecualian yang dihasilkan dari perubahan yang dibuat oleh utas lain.

Lihat juga

• IsSynchronized
• Synchronized(Hashtable)