DictionaryBase.ICollection.SyncRoot 속성

정의

DictionaryBase 개체에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.Gets an object that can be used to synchronize access to a DictionaryBase object.

property System::Object ^ System::Collections::ICollection::SyncRoot { System::Object ^ get(); };
object System.Collections.ICollection.SyncRoot { get; }
System.Collections.ICollection.SyncRoot
 ReadOnly Property SyncRoot As Object Implements ICollection.SyncRoot

속성 값

DictionaryBase 개체에 대한 액세스를 동기화하는 데 사용할 수 있는 개체입니다.An object that can be used to synchronize access to the DictionaryBase object.

구현

예제

다음 코드 예제에서는 전체 열거를 수행 하는 동안 SyncRoot 속성을 사용 하 여 컬렉션을 잠그는 방법을 보여 줍니다.The following code example shows how to lock the collection using the SyncRoot property during the entire enumeration.

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)입니다.Retrieving the value of this property is an O(1) operation.

설명

파생 클래스는 SyncRoot 속성을 사용 하 여 DictionaryBase 클래스의 동기화 된 버전을 제공할 수 있습니다.Derived classes can provide their own synchronized version of the DictionaryBase class using the SyncRoot property. 동기화 코드는 DictionaryBase 개체에서 직접 수행 하는 것이 아니라 DictionaryBase 개체의 SyncRoot 속성에 대 한 작업을 수행 해야 합니다.The synchronizing code must perform operations on the SyncRoot property of the DictionaryBase object, not directly on the DictionaryBase object. 이렇게 하면 다른 개체에서 파생되는 컬렉션에 대해 적절한 작업이 수행됩니다.This ensures proper operation of collections that are derived from other objects. 특히, 동시에 수정할 수 있는 다른 스레드와 적절 한 동기화를 유지 관리는 DictionaryBase 개체입니다.Specifically, it maintains proper synchronization with other threads that might be simultaneously modifying the DictionaryBase object.

컬렉션 전체를 열거하는 프로시저는 기본적으로 스레드로부터 안전하지 않습니다.Enumerating through a collection is intrinsically not a thread-safe procedure. 컬렉션이 동기화되어 있을 때 다른 스레드에서 해당 컬렉션을 수정할 수 있으므로 이렇게 되면 열거자에서 예외가 throw됩니다.Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. 열거하는 동안 스레드로부터 안전을 보장하려면 전체 열거를 수행하는 동안 컬렉션을 잠그거나 다른 스레드에서 변경된 내용으로 인해 발생한 예외를 catch하면 됩니다.To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.

적용 대상

추가 정보