PropertyCollection.ICollection.SyncRoot Propriedade

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

Valor de Propriedade

Um objeto que pode ser usado para sincronizar o acesso ao ICollection.

Implementações

Observações

Para coleções cujo armazenamento subjacente não está disponível publicamente, a implementação esperada é devolver a instância atual. Note que o ponteiro para a instância atual pode não ser suficiente para coleções que envolvem outras coleções; esses devem devolver a propriedade SyncRoot da coleção subjacente.

A maioria das classes de coleção no System.Collections namespace também implementa um método Synchronized, que fornece um wrapper sincronizado em torno da coleção subjacente. No entanto, as classes derivadas podem fornecer a sua própria versão sincronizada da coleção usando a SyncRoot propriedade. O código de sincronização deve realizar operações sobre o SyncRoot da coleção, não diretamente sobre a coleção. Isto assegura o funcionamento adequado das coleções derivadas de outros objetos. Especificamente, mantém a sincronização adequada com outros threads que possam estar a modificar simultaneamente a instância de colecção.

Na ausência de um método Synchronized numa coleção, o uso esperado para SyncRoot é o seguinte:

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

Dim myCollection as New ICollection()
 SyncLock myCollection.SyncRoot
  ' Some operation on the collection, which is now thread safe.
 End SyncLock

Enumerar através de uma coleção não é intrinsecamente um procedimento seguro para threads. Mesmo quando uma coleção está sincronizada, outros threads ainda podem modificar a coleção, o que faz com que o enumerador lance uma exceção. Para garantir a segurança dos threads durante a enumeração, pode bloquear a coleção durante toda a enumeração ou apanhar as exceções resultantes de alterações feitas por outros threads.

O seguinte exemplo de código mostra como bloquear a coleção usando o SyncRoot durante toda a enumeração:

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

Dim myCollection As New ICollection()
 Dim item As Object
 SyncLock myCollection.SyncRoot
  For Each item In myCollection
  ' Insert your code here.
  Next item
 End SyncLock

Ver também

• IsSynchronized