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 a funcionalidade transacional durante a adição de 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 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. |
