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