StringDictionary.SyncRoot Properti

Definisi

Ruang nama:

System.Collections.Specialized

Rakitan:

System.Collections.Specialized.dll

Sumber:

StringDictionary.cs

Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke StringDictionary.

public:
 virtual property System::Object ^ SyncRoot { System::Object ^ get(); };

public virtual object SyncRoot { get; }

member this.SyncRoot : obj

Public Overridable ReadOnly Property SyncRoot As Object

Nilai Properti

Object

Yang Object dapat digunakan untuk menyinkronkan akses ke StringDictionary.

Contoh

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

StringDictionary^ myCollection = gcnew StringDictionary();
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);
    }
}

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

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

Mengambil nilai properti ini adalah operasi O(1).

Keterangan

Kelas turunan dapat menyediakan versi StringDictionary properti yang disinkronkan sendiri menggunakan SyncRoot properti . Kode sinkronisasi harus melakukan operasi pada SyncRoot dari StringDictionary, tidak langsung pada StringDictionary. 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 StringDictionary 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.