PropertyCollection.ICollection.SyncRoot 屬性

定義

命名空間:

System.DirectoryServices

組件:

System.DirectoryServices.dll

套件:

System.DirectoryServices v8.0.0

來源:

PropertyCollection.cs

取得可用以同步存取 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

屬性值

Object

可用來同步存取 ICollection 的物件。

實作

SyncRoot

備註

對於那些無法公開使用基礎存放區的集合而言，所預期的實作會傳回目前的執行個體。 請注意，目前實例的指標可能不足以包裝其他集合的集合;這些應該會傳回基礎集合的 SyncRoot 屬性。

命名空間中的 System.Collections 大部分集合類別也會實作 Synchronized 方法，以提供基礎集合周圍的同步包裝函式。 然而，衍生類別 (Derived Class) 可以使用 SyncRoot 屬性，提供它們自己集合的同步化版本。 同步程式代碼必須在集合的 上 SyncRoot 執行作業，而不是直接在集合上執行。 如此可確保衍生自其他物件的集合可以正常運作， 特別是可以與其他可能同時修改集合執行個體的執行緒，保持正常的同步處理。

在集合上沒有 Synchronized 方法時，預期的用法 SyncRoot 如下所示：

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  

透過集合列舉本質上不是安全線程程式。 即使集合經過同步化，其他的執行緒仍可修改該集合，使列舉值擲回例外狀況。 若要保證列舉過程的執行緒安全，您可以在整個列舉過程中鎖定集合，或攔截由其他執行緒的變更所造成的例外狀況。

下列程式代碼範例示範如何在整個列舉期間使用 SyncRoot 鎖定集合：

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  

另請參閱

• IsSynchronized