NameObjectCollectionBase.ICollection.SyncRoot Properti

Definisi

Ruang nama:

System.Collections.Specialized

Rakitan:

System.Collections.Specialized.dll

Sumber:

NameObjectCollectionBase.cs

Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke NameObjectCollectionBase 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 NameObjectCollectionBase objek.

Penerapan

SyncRoot

Keterangan

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

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

// Create a collection derived from NameObjectCollectionBase
ICollection^ myCollection = gcnew DerivedCollection();
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);
    }
}

// Create a collection derived from NameObjectCollectionBase
ICollection myCollection = new DerivedCollection();
lock(myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}

' Create a collection derived from NameObjectCollectionBase
Dim myCollection As ICollection = New DerivedCollection()
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).

Lihat juga

• IsSynchronized