NameObjectCollectionBase.KeysCollection.ICollection.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 NameObjectCollectionBase.KeysCollection.
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
Objek yang dapat digunakan untuk menyinkronkan akses ke NameObjectCollectionBase.KeysCollection.
Penerapan
Contoh
Contoh kode berikut menunjukkan cara mengunci koleksi menggunakan SyncRoot selama seluruh enumerasi.
// Create a collection derived from NameObjectCollectionBase
NameObjectCollectionBase^ myBaseCollection = gcnew DerivedCollection();
// Get the ICollection from NameObjectCollectionBase.KeysCollection
ICollection^ myKeysCollection = myBaseCollection->Keys;
bool lockTaken = false;
try
{
Monitor::Enter(myKeysCollection->SyncRoot, lockTaken);
for each (Object^ item in myKeysCollection)
{
// Insert your code here.
}
}
finally
{
if (lockTaken)
{
Monitor::Exit(myKeysCollection->SyncRoot);
}
}
// Create a collection derived from NameObjectCollectionBase
NameObjectCollectionBase myBaseCollection = new DerivedCollection();
// Get the ICollection from NameObjectCollectionBase.KeysCollection
ICollection myKeysCollection = myBaseCollection.Keys;
lock(myKeysCollection.SyncRoot)
{
foreach (object item in myKeysCollection)
{
// Insert your code here.
}
}
' Create a collection derived from NameObjectCollectionBase
Dim myBaseCollection As NameObjectCollectionBase = New DerivedCollection()
' Get the ICollection from NameObjectCollectionBase.KeysCollection
Dim myKeysCollection As ICollection = myBaseCollection.Keys
SyncLock myKeysCollection.SyncRoot
For Each item As Object In myKeysCollection
' Insert your code here.
Next item
End SyncLock
Mengambil nilai properti ini adalah operasi O(1).
Keterangan
Kelas turunan dapat menyediakan versi NameObjectCollectionBase.KeysCollectionSyncRoot properti yang disinkronkan sendiri. Kode sinkronisasi harus melakukan operasi pada SyncRoot , NameObjectCollectionBase.KeysCollectiontidak langsung pada NameObjectCollectionBase.KeysCollection. Ini memastikan pengoperasian koleksi yang tepat yang berasal dari objek lain. Secara khusus, ini mempertahankan sinkronisasi yang tepat dengan utas lain yang mungkin secara bersamaan memodifikasi NameObjectCollectionBase.KeysCollection 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.