ICancelAddNew Interface

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Adiciona a funcionalidade transacional durante a adição de um novo item a uma coleção.

public interface class ICancelAddNew

public interface ICancelAddNew

type ICancelAddNew = interface

Public Interface ICancelAddNew

Derivado

System.ComponentModel.BindingList<T>

System.Windows.Forms.BindingSource

Comentários

A ICancelAddNew interface permite que uma coleção adicione um novo item de uma maneira extensível. Posteriormente, o novo item pode ser confirmado ou revertido. O AddNew método da coleção é usado para adicionar provisoriamente o item, que é posteriormente transacionado por meio das seguintes operações:

• O EndNew método confirmará explicitamente a adição pendente.

• Executar outra operação de coleção, como uma inserção, remoção ou movimentação, confirmará implicitamente a adição pendente.

• O CancelNew método reverterá a adição pendente se ainda não tiver sido confirmado.

Observação

Em alguns cenários, como Windows Forms associação de dados complexa, a coleção pode receber CancelNew ou EndNew chamar itens diferentes do item recém-adicionado. (Cada item normalmente é uma linha em uma exibição de dados.) Ignorar essas chamadas; cancele ou confirme o novo item somente quando o índice desse item for especificado.

Há dois modelos que permitem a adição transacional de um item a uma coleção associada a dados:

• O modelo mais antigo depende diretamente de uma coleção que implementa a IBindingList interface e é associada a dados diretamente usando a System.Windows.Forms.CurrencyManager classe . Os AddNewmétodos , EndCurrentEdite CancelCurrentEdit da System.Windows.Forms.CurrencyManager classe são responsáveis pelo suporte transacional para adicionar novos itens. No entanto, essa funcionalidade depende dos itens que dão suporte ao comportamento transacional por meio da IEditableObject interface . Se os itens não derem suporte a essa interface, o item sempre será adicionado à lista, independentemente das chamadas subsequentes para CancelCurrentEdit.

• O modelo mais recente dá suporte a um cenário de associação de dados mais robusto por meio da classe genérica BindingList<T> , que implementa as IBindingList interfaces e ICancelAddNew . Nesse caso, o suporte transacional é gerenciado pela BindingList<T> coleção diretamente.

Métodos

CancelNew(Int32)	Descarta um novo item pendente da coleção.
EndNew(Int32)	Confirma um novo item pendente para a coleção.

Confira também

• IBindingList
• CurrencyManager
• IEditableObject
• BindingList<T>