BindingOperations.EnableCollectionSynchronization Método

public:
 static void EnableCollectionSynchronization(System::Collections::IEnumerable ^ collection, System::Object ^ lockObject);

public static void EnableCollectionSynchronization(System.Collections.IEnumerable collection, object lockObject);

static member EnableCollectionSynchronization : System.Collections.IEnumerable * obj -> unit

Public Shared Sub EnableCollectionSynchronization (collection As IEnumerable, lockObject As Object)

Parâmetros

Observações

Uma aplicação WPF pode exibir uma coleção de dados usando um ItemsControl ou uma das suas subclasses (ListBox, DataGrid, TreeView, ListView, etc.). WPF canaliza todo o seu acesso à coleção através de uma subclasse de CollectionView. Tanto o ItemsControl como o CollectionView têm afinidade com o fio em que o ItemsControl foi criado, o que significa que usá-los num fio diferente é proibido e cria uma exceção. Na prática, esta restrição aplica-se também à coleção.

Podes querer usar a coleção em vários threads. Por exemplo, deve atualizar a coleção (adicionar ou remover itens) num tópico de "recolha de dados", enquanto exibe os resultados num tópico de "interface de utilizador", para que a interface se mantenha responsiva durante a recolha de dados. Nessa situação, é responsável por garantir o acesso sincronizado ("thread-safe") à coleção e por garantir que o acesso de WPF (especificamente de CollectionView) participe no mesmo mecanismo de sincronização. Ao chamar o EnableCollectionSynchronization(IEnumerable, Object) método, pode fazê-lo usando um mecanismo simples de bloqueio.

Para usar uma coleção em múltiplos threads, um dos quais é o thread da interface que detém o ItemsControl, deve fazer o seguinte:

1. Instância de um objeto para bloquear ao aceder à coleção.

2. Sincroniza todos os acessos da aplicação para a coleção bloqueando esse objeto.

3. Ligue para EnableCollectionSynchronization(IEnumerable, Object) para informar WPF que está a usar um mecanismo de fechadura simples.

   • A chamada deve ocorrer no tópico da interface.

   • A chamada deve ocorrer antes de usar a coleção numa thread diferente ou antes de anexar a coleção à ItemsControl, o que ocorrer mais tarde.

4. Assegure que uma alteração na coleção e a notificação dessa alteração (através de INotifyCollectionChanged) são atómicas; nenhum acesso de outros threads pode intervir. (Isto é normalmente gratuito. Por exemplo, ObservableCollection<T> garante isto, desde que todas as alterações estejam protegidas por sincronização.)

5. Se chamares DisableCollectionSynchronization, essa chamada também tem de ocorrer no tópico da interface.

6. Se quiseres usar a mesma coleção em múltiplos threads UI, deves chamar EnableCollectionSynchronization (e DisableCollectionSynchronization, se necessário) separadamente em cada thread UI.

7. Evita o impasse. Esta já é responsabilidade da aplicação assim que esta decide usar a sincronização, mas também deve ter em conta a participação do WPF na sincronização. (Ver mais abaixo.)

Em troca, o WPF fornece o seguinte comportamento:

• Acede CollectionView à coleção usando o mecanismo de bloqueio.

• O CollectionView mantém uma "cópia sombra" da coleção para uso no tópico da interface.

• CollectionChanged Os eventos são alinhados à medida que chegam (em qualquer tópico).

• Os eventos pendentes são aplicados à cópia sombra de forma assíncrona no tópico da interface quando esta tem oportunidade de o fazer.

• Não CollectionView utilizam diretamente nenhum outro mecanismo de sincronização visível para a aplicação. Esta é a forma da WPF ajudar a evitar o impasse (ver o item anterior 7).

O efeito líquido é que podes alterar a coleção em qualquer tópico, e essas alterações acabam por aparecer quando ItemsControl o tópico da interface tem tempo para "recuperar o atraso". A implementação foi ajustada para reduzir a velocidade com que as mudanças fluem para a thread da interface, para evitar que threads em segundo plano saturem a thread e privem a resposta à entrada normal do utilizador.

public:
 static void EnableCollectionSynchronization(System::Collections::IEnumerable ^ collection, System::Object ^ context, System::Windows::Data::CollectionSynchronizationCallback ^ synchronizationCallback);

public static void EnableCollectionSynchronization(System.Collections.IEnumerable collection, object context, System.Windows.Data.CollectionSynchronizationCallback synchronizationCallback);

static member EnableCollectionSynchronization : System.Collections.IEnumerable * obj * System.Windows.Data.CollectionSynchronizationCallback -> unit

Public Shared Sub EnableCollectionSynchronization (collection As IEnumerable, context As Object, synchronizationCallback As CollectionSynchronizationCallback)

Parâmetros

Observações

Uma aplicação WPF pode exibir uma coleção de dados usando um ItemsControl ou uma das suas subclasses (ListBox, DataGrid, TreeView, ListView, etc.). WPF canaliza todo o seu acesso à coleção através de uma subclasse de CollectionView. Tanto o ItemsControl como o CollectionView têm afinidade com o fio em que o ItemsControl foi criado, o que significa que usá-los num fio diferente é proibido e cria uma exceção. Na prática, esta restrição aplica-se também à coleção.

Podes querer usar a coleção em vários threads. Por exemplo, deve atualizar a coleção (adicionar ou remover itens) num tópico de "recolha de dados", enquanto exibe os resultados num tópico de "interface de utilizador", para que a interface se mantenha responsiva durante a recolha de dados. Nessa situação, é responsável por garantir o acesso sincronizado ("thread-safe") à coleção e por garantir que o acesso de WPF (especificamente de CollectionView) participe no mesmo mecanismo de sincronização. Ao chamar o EnableCollectionSynchronization(IEnumerable, Object, CollectionSynchronizationCallback) método, pode fazê-lo usando um mecanismo de sincronização, como um semáforo, um evento de reset, etc.

Para usar uma coleção em múltiplos threads, um dos quais é o thread da interface que detém o ItemsControl, deve fazer o seguinte:

1. Escolha um mecanismo de sincronização.

2. Sincronize todos os acessos da aplicação para a coleção usando esse mecanismo.

3. Liga para a sobrecarga EnableCollectionSynchronization(IEnumerable, Object, CollectionSynchronizationCallback) para informar WPF que estás a usar um mecanismo diferente do bloqueio simples.

   • A chamada deve ocorrer no tópico da interface.

   • A chamada deve ocorrer antes de usar a coleção numa thread diferente ou antes de anexar a coleção à ItemsControl, o que ocorrer mais tarde.

4. Assegure que uma alteração na coleção e a notificação dessa alteração (através de INotifyCollectionChanged) são atómicas; nenhum acesso de outros threads pode intervir. (Isto é normalmente gratuito. Por exemplo, ObservableCollection<T> garante isto, desde que todas as alterações estejam protegidas por sincronização.)

5. Se chamares DisableCollectionSynchronization, essa chamada também tem de ocorrer no tópico da interface.

6. Se quiseres usar a mesma coleção em múltiplos threads UI, deves chamar EnableCollectionSynchronization (e DisableCollectionSynchronization, se necessário) separadamente em cada thread UI.

7. Evita o impasse. Esta já é responsabilidade da aplicação assim que esta decide usar a sincronização, mas também deve ter em conta a participação do WPF na sincronização. (Ver mais abaixo.)

Em troca, o WPF fornece o seguinte comportamento:

• Acede CollectionView à coleção chamando o registado CollectionSynchronizationCallback com os seguintes argumentos:

  • collection: a coleção de interessos.
  • context: o objeto de contexto registado.
  • accessMethod: um delegado que realiza o acesso efetivo.
  • writeAccess: true se o delegado modificar a coleção; false caso contrário.

  CollectionSynchronizationCallback Deves estabelecer a sincronização na coleção (usando o context objeto e o writeAccess valor, conforme apropriado), chamar o accessMethod, e depois libertar a sincronização.

• O CollectionView mantém uma "cópia sombra" da coleção para uso no tópico da interface.

• CollectionChanged Os eventos são alinhados à medida que chegam (em qualquer tópico).

• Os eventos pendentes são aplicados à cópia sombra de forma assíncrona no tópico da interface quando esta tem oportunidade de o fazer.

• Não CollectionView utilizam diretamente nenhum outro mecanismo de sincronização visível para a aplicação. Esta é a forma da WPF ajudar a evitar o impasse (ver o item anterior 7).

O efeito líquido é que podes alterar a coleção em qualquer tópico, e essas alterações acabam por aparecer quando ItemsControl o tópico da interface tem tempo para "recuperar o atraso". A implementação foi ajustada para reduzir a velocidade com que as mudanças fluem para a thread da interface, para evitar que threads em segundo plano saturem a thread e privem a resposta à entrada normal do utilizador.

O context parâmetro é um objeto arbitrário que é passado ao callback. Pode usá-lo para determinar o mecanismo de sincronização usado para controlar o acesso a collection. Context pode ser null.