CollectionBase.ICollection.SyncRoot 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得一個物件,可用來同步存取 CollectionBase。
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
屬性值
一個可以用來同步存取 CollectionBase的物件。
實作
備註
衍生類別可以利用該CollectionBase特性提供自己的同步版本SyncRoot。 同步碼必須對 SyncRoot 的 CollectionBase執行操作,而非直接對 CollectionBase。 這確保了從其他物件衍生出的集合的正確運作。 具體來說,它會與可能同時修改 CollectionBase 該物件的其他執行緒保持適當的同步。
透過集合列舉本質上不是一個執行緒安全的程序。 即使集合同步處理,其他線程仍然可以修改集合,這會導致列舉值擲回例外狀況。 若要保證列舉期間的線程安全性,您可以在整個列舉期間鎖定集合,或攔截其他線程所做的變更所產生的例外狀況。
以下程式碼範例展示了如何在整個列舉過程中使用 鎖定 SyncRoot 集合:
// Get the ICollection interface from the CollectionBase
// derived class.
ICollection myCollection = myCollectionBase;
lock(myCollection.SyncRoot)
{
foreach (object item in myCollection)
{
// Insert your code here.
}
}
' Get the ICollection interface from the CollectionBase
' derived class.
Dim myCollection As ICollection = myCollectionBase
SyncLock myCollection.SyncRoot
For Each item As Object In myCollection
' Insert your code here.
Next item
End SyncLock
取得該屬性的價值是一個 O(1) 操作。