ReadOnlyCollectionBase.ICollection.SyncRoot Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém um objeto que pode ser usado para sincronizar o acesso a um ReadOnlyCollectionBase objeto.
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 ReadOnlyCollectionBase objeto.
Implementações
Exemplos
O exemplo de código seguinte mostra como bloquear a coleção usando a SyncRoot propriedade durante toda a enumeração.
// Get the ICollection interface from the ReadOnlyCollectionBase
// derived class.
ICollection myCollection = myReadOnlyCollection;
lock(myCollection.SyncRoot)
{
foreach (object item in myCollection)
{
// Insert your code here.
}
}
' Get the ICollection interface from the ReadOnlyCollectionBase
' derived class.
Dim myCollection As ICollection = myReadOnlyCollection
SyncLock myCollection.SyncRoot
For Each item As Object In myCollection
' Insert your code here.
Next item
End SyncLock
Recuperar o valor desta propriedade é uma O(1) operação.
Observações
As classes derivadas podem fornecer a sua própria versão sincronizada da ReadOnlyCollectionBase classe usando a SyncRoot propriedade. O código de sincronização deve realizar operações sobre a SyncRoot propriedade do ReadOnlyCollectionBase objeto, não diretamente sobre o ReadOnlyCollectionBase objeto. 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 o ReadOnlyCollectionBase objeto.
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.