SchemaNameCollection.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 da SyncRoot coleção subjacente.

A maioria das classes de coleção no System.Collections namespace também implementa um Synchronized método, 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 Synchronized método 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 exemplo seguinte 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