Compartilhar via


ICancelAddNew Interface

Definição

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

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:

Métodos

CancelNew(Int32)

Descarta um novo item pendente da coleção.

EndNew(Int32)

Confirma um novo item pendente para a coleção.

Aplica-se a

Confira também