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