ICancelAddNew Interface
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.
Adiciona funcionalidade transacional ao adicionar um novo item a uma coleção.
public interface class ICancelAddNewpublic interface ICancelAddNewtype ICancelAddNew = interfacePublic Interface ICancelAddNew- Derivado
Comentários
A ICancelAddNew interface permite que uma coleção adicione um novo item de forma extensível. O novo item posteriormente 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 método EndNew 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.
Note
Em alguns cenários, como Windows Forms associação de dados complexa, a coleção pode receber CancelNew ou EndNew chamadas para 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 interface IBindingList e é associada a dados diretamente usando a classe System.Windows.Forms.CurrencyManager. Os métodos AddNew, EndCurrentEdit e CancelCurrentEdit da classe System.Windows.Forms.CurrencyManager 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éricaBindingList<T>, que implementa o e ICancelAddNew as IBindingList interfaces. Nesse caso, o suporte transacional é gerenciado pela BindingList<T> coleção diretamente.
Métodos
| Nome | Description |
|---|---|
| CancelNew(Int32) |
Descarta um novo item pendente da coleção. |
| EndNew(Int32) |
Confirma um novo item pendente para a coleção. |