DictionaryBase.ICollection.SyncRoot 屬性

定義

命名空間:

System.Collections

組件:

System.Collections.NonGeneric.dll

來源:

DictionaryBase.cs

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

屬性值

Object

可用來同步處理對 DictionaryBase 物件之存取的物件。

實作

SyncRoot

範例

下列程式代碼範例示範如何在整個列舉期間使用 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) 。

備註

衍生類別可以使用 屬性來提供自己的已同步處理類別DictionaryBaseSyncRoot版本。 同步程式代碼必須在 對象的屬性DictionaryBase上SyncRoot執行作業，而不是直接在 對象上DictionaryBase執行。 如此可確保衍生自其他物件的集合可以正常運作， 具體而言，它會與可能同時修改 DictionaryBase 物件的其他線程維持適當的同步處理。

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

另請參閱

• IsSynchronized
• Synchronized(Hashtable)