TreeNodeCollection.SyncRoot Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém um objeto que pode ser usado para sincronizar o acesso ao objeto TreeNodeCollection.
public:
property System::Object ^ SyncRoot { System::Object ^ get(); };
public object SyncRoot { get; }
member this.SyncRoot : obj
Public ReadOnly Property SyncRoot As Object
Valor da propriedade
Um Object que pode ser usado para sincronizar o TreeNodeCollectionacesso ao .
Implementações
Comentários
A SyncRoot propriedade fornece uma versão sincronizada do TreeNodeCollection que pode ser usado com o código de sincronização (threading).
Cuidado
A IsSynchronized propriedade dessa classe sempre retorna false
, o que indica que a TreeNodeCollection classe não está sincronizada (não thread safe).
A sincronização do código deve executar operações no SyncRoot objeto do TreeNodeCollection, não diretamente no TreeNodeCollection próprio. 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 o TreeNodeCollection objeto.
Observação
O objeto retornado nesta implementação é o System.Collections.ArrayList objeto usado para armazenar os TreeNode objetos na coleção.
A enumeração por meio de uma coleção não é um procedimento thread-safe intrínseco. Mesmo quando uma coleção é sincronizada, outros threads ainda podem modificar a coleção, o que faz com que o enumerador gere 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.
Para obter mais informações sobre a SyncRoot propriedade, consulte a ICollection.SyncRoot propriedade da System.Collections.ICollection interface.