ICancelAddNew ICancelAddNew ICancelAddNew ICancelAddNew Interface

Definizione

Aggiunge funzionalità transazionali al momento dell'aggiunta di un nuovo elemento a un insieme.Adds transactional capability when adding a new item to a collection.

public interface class ICancelAddNew
public interface ICancelAddNew
type ICancelAddNew = interface
Public Interface ICancelAddNew
Derivato

Commenti

L' ICancelAddNew interfaccia consente a una raccolta di aggiungere un nuovo elemento in modo estendibile.The ICancelAddNew interface enables a collection to add a new item in an extensible way. Successivamente, è possibile eseguire il commit o il rollback del nuovo elemento.The new item subsequently can be committed or rolled back. Il AddNew metodo della raccolta viene usato per aggiungere provvisoriamente l'elemento, che viene successivamente sottoposto a transazione tramite le operazioni seguenti:The AddNew method of the collection is used to tentatively add the item, which is subsequently transacted through the following operations:

  • Il EndNew metodo eseguirà il commit esplicito dell'addizione in sospeso.The EndNew method will explicitly commit the pending addition.

  • L'esecuzione di un'altra operazione di raccolta, ad esempio l'inserimento, la rimozione o lo spostamento, eseguirà implicitamente il commit dell'aggiunta in sospeso.Performing another collection operation, such as an insertion, removal, or move will implicitly commit the pending addition.

  • Se CancelNew non è già stato eseguito il commit, il metodo eseguirà il rollback dell'aggiunta in sospeso.The CancelNew method will roll back the pending addition if it has not already been committed.

Nota

In alcuni scenari, ad esempio Windows Forms Data Binding complessi, la raccolta può ricevere CancelNew o EndNew chiamare elementi diversi dall'elemento appena aggiunto.In some scenarios, such as Windows Forms complex data binding, the collection may receive CancelNew or EndNew calls for items other than the newly added item. Ogni elemento è in genere una riga in una visualizzazione dati. Ignorare queste chiamate; annullare o eseguire il commit del nuovo elemento solo quando viene specificato l'indice dell'elemento.(Each item is typically a row in a data view.) Ignore these calls; cancel or commit the new item only when that item's index is specified.

Esistono due modelli che consentono l'aggiunta transazionale di un elemento a una raccolta con associazione a dati:There are two models that allow transactional addition of an item to a data-bound collection:

Metodi

CancelNew(Int32) CancelNew(Int32) CancelNew(Int32) CancelNew(Int32)

Elimina dall'insieme un nuovo elemento in sospeso.Discards a pending new item from the collection.

EndNew(Int32) EndNew(Int32) EndNew(Int32) EndNew(Int32)

Esegue il commit di un nuovo elemento in sospeso nell'insieme.Commits a pending new item to the collection.

Si applica a

Vedi anche