Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad ICollection.SyncRoot

 

Publicado: octubre de 2016

Obtiene un objeto que se puede usar para sincronizar el acceso a ICollection.

Espacio de nombres:   System.Collections
Ensamblado:  mscorlib (en mscorlib.dll)

object SyncRoot { get; }

Valor de propiedad

Type: System.Object

Objeto que se puede usar para sincronizar el acceso a ICollection.

Para las colecciones cuyo almacenamiento subyacente no esté disponible públicamente, la implementación esperada tan sólo debe devolver la instancia actual. Tenga en cuenta que el puntero a la instancia actual puede no ser suficiente para las colecciones que contienen otras colecciones; ésas deben devolver la colección subyacente SyncRoot propiedad.

La mayoría de las clases de colección del espacio de nombres System.Collections también implementan un método Synchronized que proporciona un contenedor sincronizado alrededor de la colección subyacente. Sin embargo, las clases derivadas pueden proporcionar su propia versión sincronizada de la colección mediante la propiedad SyncRoot. El código de la sincronización debe realizar las operaciones en la propiedad SyncRoot de la colección, y no directamente en la colección. De este modo, se garantiza el funcionamiento correcto de las colecciones derivadas de otros objetos. En concreto, mantiene la sincronización correcta con otros subprocesos que podrían modificar al mismo tiempo la instancia de la colección.

En ausencia de un Synchronized método en una colección, el uso esperado de SyncRoot tiene el aspecto siguiente:

ICollection myCollection = someCollection;
lock(myCollection.SyncRoot)
{
    // Some operation on the collection, which is now thread safe.
}

Enumerar una colección no es intrínsecamente un procedimiento seguro para subprocesos. Incluso cuando una colección está sincronizada, otros subprocesos todavía pueden modificarla, lo que hace que el enumerador produzca una excepción. 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.

En el ejemplo de código siguiente se muestra cómo bloquear la colección utilizando la SyncRoot propiedad durante toda la enumeración.

ICollection myCollection = someCollection;
lock(myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: