DictionaryBase.ICollection.SyncRoot 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得可用來同步存取 DictionaryBase 物件的物件。
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
屬性值
可用來同步處理對 DictionaryBase 物件之存取的物件。
實作
範例
下列程式碼範例示範如何在整個列舉期間使用 SyncRoot 屬性鎖定集合。
ICollection^ myCollection = gcnew ShortStringDictionary();
bool lockTaken = false;
try
{
Monitor::Enter(myCollection->SyncRoot, lockTaken);
for each (Object^ item in myCollection);
{
// Insert your code here.
}
}
finally
{
if (lockTaken)
{
Monitor::Exit(myCollection->SyncRoot);
}
}
ICollection myCollection = new ShortStringDictionary();
lock(myCollection.SyncRoot)
{
foreach (Object item in myCollection)
{
// Insert your code here.
}
}
Dim myCollection As ICollection = New ShortStringDictionary()
SyncLock myCollection.SyncRoot
For Each item In myCollection
' Insert your code here.
Next item
End SyncLock
擷取這個屬性的值是 O(1)
作業。
備註
衍生類別可以使用 屬性提供自己的同步處理類別版本 DictionaryBase SyncRoot 。 同步程式碼必須在 物件的 屬性 DictionaryBase 上 SyncRoot 執行作業,而不是直接在 DictionaryBase 物件上執行。 如此可確保衍生自其他物件的集合可以正常運作, 具體而言,它會與可能同時修改 DictionaryBase 物件的其他執行緒維持適當的同步處理。
透過集合進行列舉在本質上並非安全執行緒程序。 即使集合經過同步化,其他的執行緒仍可修改該集合,使列舉值擲回例外狀況。 若要保證列舉過程的執行緒安全,您可以在整個列舉過程中鎖定集合,或攔截由其他執行緒的變更所造成的例外狀況。