INotifyCollectionChanged Interface

Definição

Notifica os ouvintes de alterações dinâmicas, como quando um item é adicionado e removido ou toda a lista é limpa.Notifies listeners of dynamic changes, such as when an item is added and removed or the whole list is cleared.

public interface class INotifyCollectionChanged
public interface INotifyCollectionChanged
type INotifyCollectionChanged = interface
Public Interface INotifyCollectionChanged
Derivado

Comentários

Você pode enumerar em qualquer coleção que implemente a IEnumerable interface.You can enumerate over any collection that implements the IEnumerable interface. No entanto, para configurar associações dinâmicas para que as inserções ou exclusões na coleção atualizem o Interface do usuárioUI automaticamente, a coleção deve implementar a INotifyCollectionChanged interface.However, to set up dynamic bindings so that insertions or deletions in the collection update the Interface do usuárioUI automatically, the collection must implement the INotifyCollectionChanged interface. Essa interface expõe o CollectionChanged evento que deve ser gerado sempre que a coleção subjacente é alterada.This interface exposes the CollectionChanged event that must be raised whenever the underlying collection changes.

WPFWPF fornece a ObservableCollection<T> classe, que é uma implementação interna de uma coleção de dados que expõe a INotifyCollectionChanged interface.provides the ObservableCollection<T> class, which is a built-in implementation of a data collection that exposes the INotifyCollectionChanged interface. Para obter um exemplo, consulte como: criar e associar a uma ObservableCollection.For an example, see How to: Create and Bind to an ObservableCollection.

Os objetos de dados individuais dentro da coleção devem atender aos requisitos descritos na visão geral de fontes de associação.The individual data objects within the collection must satisfy the requirements described in the Binding Sources Overview.

Antes de implementar sua própria coleção, considere usar ObservableCollection<T> ou uma das classes de coleção existentes, como List<T> , Collection<T> e BindingList<T> , entre muitas outras.Before implementing your own collection, consider using ObservableCollection<T> or one of the existing collection classes, such as List<T>, Collection<T>, and BindingList<T>, among many others.

Se você tiver um cenário avançado e quiser implementar sua própria coleção, considere usar IList o, que fornece uma coleção não genérica de objetos que podem ser acessados individualmente pelo índice e fornece o melhor desempenho.If you have an advanced scenario and want to implement your own collection, consider using IList, which provides a non-generic collection of objects that can be individually accessed by index and provides the best performance.

Eventos

CollectionChanged

Ocorre quando a coleção é alterada.Occurs when the collection changes.

Aplica-se a

Confira também