SearchResultCollection.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 da propriedade

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

Implementações

Comentários

Para coleções cujo repositório subjacente não está disponível publicamente, a implementação esperada é retornar a instância atual. Observe que o ponteiro para a instância atual pode não ser suficiente para coleções que encapsulam outras coleções; eles devem retornar 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 sua própria versão sincronizada da coleção usando a SyncRoot propriedade . O código de sincronização deve executar operações no SyncRoot da coleção, não diretamente na coleção. Isso garante a operação apropriada das coleções que são derivadas de outros objetos. Especificamente, ele mantém a sincronização adequada com outros threads que podem estar modificando simultaneamente a instância da coleção.

Na ausência de um Synchronized método em uma coleção, o uso esperado para SyncRoot é semelhante a este:

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 por meio de uma coleção não é intrinsecamente um procedimento thread-safe. Mesmo quando uma coleção está sincronizada, outros threads ainda podem modificar a coleção, o que faz o enumerador lançar uma exceção. Para garantir thread-safe durante a enumeração, é possível bloquear a coleção durante toda a enumeração ou verificar as exceções resultantes das alterações feitas por outros threads.

O exemplo de código a seguir 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  

Aplica-se a

Confira também

• IsSynchronized