ListDictionary.SyncRoot Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke ListDictionary.
public:
property System::Object ^ SyncRoot { System::Object ^ get(); };
public object SyncRoot { get; }
member this.SyncRoot : obj
Public ReadOnly Property SyncRoot As Object
Nilai Properti
Objek yang dapat digunakan untuk menyinkronkan akses ke ListDictionary.
Penerapan
Contoh
Contoh kode berikut menunjukkan cara mengunci koleksi menggunakan SyncRoot selama seluruh enumerasi.
ListDictionary^ myCollection = gcnew ListDictionary();
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);
}
}
ListDictionary myCollection = new ListDictionary();
lock(myCollection.SyncRoot)
{
foreach (object item in myCollection)
{
// Insert your code here.
}
}
Dim myCollection As New ListDictionary()
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 ListDictionary properti yang disinkronkan sendiri menggunakan SyncRoot properti . Kode sinkronisasi harus melakukan operasi pada SyncRoot dari ListDictionary, tidak langsung pada ListDictionary. 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 ListDictionary 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.