SchemaNameCollection.ICollection.SyncRoot Propriedade

Definição

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacote:

System.DirectoryServices v8.0.0

Origem:

SchemaNameCollection.cs

Obtém um objeto que pode ser usado para sincronizar o acesso ao ICollection.

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

Object

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

Implementações

SyncRoot

Comentários

Para coleções com um 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, 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  

A enumeração por meio de uma coleção não é um procedimento thread-safe intrínseco. 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 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  

Confira também

• IsSynchronized