SearchResultCollection.ICollection.SyncRoot Properti

Definisi

Ruang nama:

System.DirectoryServices

Rakitan:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Sumber:

SearchResultCollection.cs

Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke ICollection.

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 ICollection.

Penerapan

SyncRoot

Keterangan

Untuk koleksi yang penyimpanan yang mendasarnya tidak tersedia untuk umum, implementasi yang diharapkan adalah mengembalikan instans saat ini. Perhatikan bahwa penunjuk ke instans saat ini mungkin tidak cukup untuk koleksi yang membungkus koleksi lain; mereka harus mengembalikan properti koleksi yang mendasar SyncRoot .

Sebagian besar kelas koleksi di System.Collections namespace layanan juga menerapkan Synchronized metode , yang menyediakan pembungkus yang disinkronkan di sekitar koleksi yang mendasar. Namun, kelas turunan dapat menyediakan versi koleksi yang disinkronkan sendiri menggunakan SyncRoot properti . Kode sinkronisasi harus melakukan operasi pada SyncRoot koleksi, bukan langsung pada koleksi. 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 instans koleksi.

Dengan tidak adanya Synchronized metode pada koleksi, penggunaan yang diharapkan untuk SyncRoot terlihat seperti ini:

ICollection MyCollection =...  
 lock(MyCollection.SyncRoot) {  
  // Some operation on the collection, which is now thread safe.  
 }  

Dim myCollection as New ICollection()  
 SyncLock myCollection.SyncRoot  
  ' Some operation on the collection, which is now thread safe.  
 End SyncLock  

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:

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

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

Lihat juga

• IsSynchronized