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

Definición

Obtiene un objeto que se puede utilizar para sincronizar el acceso a un objeto ReadOnlyCollectionBase.Gets an object that can be used to synchronize access to a ReadOnlyCollectionBase object.

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

Valor de propiedad

Objeto que puede utilizarse para sincronizar el acceso al objeto ReadOnlyCollectionBase.An object that can be used to synchronize access to the ReadOnlyCollectionBase object.

Implementaciones

Ejemplos

El ejemplo de código siguiente muestra cómo bloquear la colección utilizando el SyncRoot propiedad durante toda la enumeración.The following code example shows how to lock the collection using the SyncRoot property during the entire enumeration.

// Get the ICollection interface from the ReadOnlyCollectionBase
// derived class.
ICollection^ myCollection = myReadOnlyCollection;
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);
    }
}
// Get the ICollection interface from the ReadOnlyCollectionBase
// derived class.
ICollection myCollection = myReadOnlyCollection;
lock(myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}
' Get the ICollection interface from the ReadOnlyCollectionBase
' derived class.
Dim myCollection As ICollection = myReadOnlyCollection
SyncLock myCollection.SyncRoot
    For Each item As Object In myCollection
        ' Insert your code here.
    Next item
End SyncLock

La recuperación del valor de esta propiedad es una operación O(1).Retrieving the value of this property is an O(1) operation.

Comentarios

Las clases derivadas pueden proporcionar su propia versión sincronizada de la ReadOnlyCollectionBase clase utilizando el SyncRoot propiedad.Derived classes can provide their own synchronized version of the ReadOnlyCollectionBase class using the SyncRoot property. El código de sincronización debe realizar operaciones en el SyncRoot propiedad de la ReadOnlyCollectionBase objeto, no directamente en el ReadOnlyCollectionBase objeto.The synchronizing code must perform operations on the SyncRoot property of the ReadOnlyCollectionBase object, not directly on the ReadOnlyCollectionBase object. De este modo, se garantiza el funcionamiento correcto de las colecciones derivadas de otros objetos.This ensures proper operation of collections that are derived from other objects. En concreto, mantiene la sincronización correcta con otros subprocesos que podrían modificar simultáneamente la ReadOnlyCollectionBase objeto.Specifically, it maintains proper synchronization with other threads that might be simultaneously modifying the ReadOnlyCollectionBase object.

Enumerar una colección no es intrínsecamente un procedimiento seguro para subprocesos.Enumerating through a collection is intrinsically not a thread-safe procedure. Incluso cuando una colección está sincronizada, otros subprocesos todavía pueden modificarla, lo que hace que el enumerador produzca una excepción.Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. Con el fin de garantizar la seguridad para la ejecución de subprocesos durante la enumeración, se puede bloquear la colección durante toda la enumeración o detectar las excepciones resultantes de los cambios realizados por otros subprocesos.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.

Se aplica a

Consulte también: