ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot Property

정의

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

public:
 property System::Object ^ SyncRoot { System::Object ^ get(); };
public object SyncRoot { get; }
member this.SyncRoot : obj
Public ReadOnly Property SyncRoot As Object

속성 값

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

설명

내부 저장소를 공개적으로 사용할 수 없는 컬렉션의 경우 예상된 구현에서는 현재 인스턴스를 반환합니다.For collections whose underlying store is not publicly available, the expected implementation is to return the current instance. 현재 인스턴스에 대 한 포인터 충분 하지 않을 다른 컬렉션을 래핑하는 컬렉션에 대 한 참고 기본 컬렉션을 반환 해야 해당 SyncRoot 속성입니다.Note that the pointer to the current instance might not be sufficient for collections that wrap other collections; those should return the underlying collection's SyncRoot property.

System.Collections 네임스페이스에 있는 대부분의 컬렉션 클래스는 내부 컬렉션에 동기화된 래퍼를 제공하는 Synchronized 메서드를 구현합니다.Most collection classes in the System.Collections namespace also implement a Synchronized method, which provides a synchronized wrapper around the underlying collection. 그러나 파생 클래스는 SyncRoot 속성을 사용하여 컬렉션의 동기화된 고유 버전을 제공할 수 있습니다.However, derived classes can provide their own synchronized version of the collection using the SyncRoot property. 동기화하는 코드는 컬렉션에 직접 작업을 수행하지 않고 컬렉션의 SyncRoot 속성에 대해 작업을 수행해야 합니다.The synchronizing code must perform operations on the SyncRoot property of the collection, not directly on the collection. 이렇게 하면 다른 개체에서 파생되는 컬렉션에 대해 적절한 작업이 수행됩니다.This ensures proper operation of collections that are derived from other objects. 특히 컬렉션 인스턴스를 동시에 수정할 수 있는 다른 스레드와 적절한 동기화가 유지됩니다.Specifically, it maintains proper synchronization with other threads that might be simultaneously modifying the collection instance.

없는 경우에는 Synchronized 컬렉션에 대 한 예상된 사용량에서 메서드 SyncRoot 모양은 다음과 같습니다:In the absence of a Synchronized method on a collection, the expected usage for SyncRoot looks as follows:

ICollection^ myCollection = someCollection;
bool lockTaken = false;
try
{
    Monitor::Enter(myCollection->SyncRoot, lockTaken);
    // Some operation on the collection, which is now thread safe.
}
finally
{
    if (lockTaken)
    {
        Monitor::Exit(myCollection->SyncRoot);
    }
}
ICollection myCollection = someCollection;
lock(myCollection.SyncRoot)
{
    // Some operation on the collection, which is now thread safe.
}
Dim myCollection As ICollection = someCollection
SyncLock myCollection.SyncRoot
    ' Some operation on the collection, which is now thread safe.
End SyncLock

컬렉션 전체를 열거하는 프로시저는 기본적으로 스레드로부터 안전하지 않습니다.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.

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

ICollection^ myCollection = someCollection;
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 = someCollection;
lock(myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}
Dim myCollection As ICollection = someCollection
SyncLock myCollection.SyncRoot
    For Each item In myCollection
        ' Insert your code here.
    Next item
End SyncLock

적용 대상

추가 정보