IBindingList.AddNew Metodo

Definizione

Consente di aggiungere un nuovo elemento all'elenco.Adds a new item to the list.

public:
 System::Object ^ AddNew();
public object AddNew ();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object

Restituisce

Object

Elemento aggiunto all'elenco.The item added to the list.

Eccezioni

Commenti

Questo metodo è supportato solo se AllowNew è true; in caso contrario, viene generata un'NotSupportedException.This method is supported only if AllowNew is true; otherwise, a NotSupportedException is thrown.

L'implementazione di questo metodo significa che l'elenco di IBindingList deve comprendere il tipo di oggetti da aggiungere all'elenco e deve comprendere come creare una nuova istanza di quel tipo.Implementing this method means that the IBindingList list must understand the type of objects to add to the list and must understand how to create a new instance of that type. Se, ad esempio, si dispone di una raccolta di oggetti myCustomer, il metodo AddNew dovrebbe aggiungere un nuovo oggetto myCustomer all'elenco.For example, if you have a collection of myCustomer objects, the AddNew method should add a new myCustomer object to the list.

Nota

Se gli oggetti in questo elenco implementano l'interfaccia IEditableObject, la chiamata al metodo CancelEdit deve rimuovere un oggetto, non aggiungerlo all'elenco, quando l'oggetto è stato creato con il metodo AddNew.If the objects in this list implement the IEditableObject interface, calling the CancelEdit method should discard an object, not add it to the list, when the object was created using the AddNew method. L'oggetto deve essere aggiunto all'elenco solo quando viene chiamato il metodo IEditableObject.EndEdit.The object should only be added to the list when the IEditableObject.EndEdit method is called. Pertanto, è necessario sincronizzare attentamente l'oggetto e l'elenco.Therefore, you must synchronize the object and the list carefully.

Quando viene chiamato questo metodo, è necessario generare un evento ListChanged con l'enumerazione ItemAdded che trasporta l'indice appropriato.When this method is called, you should raise a ListChanged event with the ItemAdded enumeration carrying the appropriate index. La riga aggiunta è in uno stato in cui la riga ESC in un controllo DataGridView può rimuovere la nuova riga.The added row is in a state where hitting Esc on a DataGridView control can remove the new row. La generazione dell'evento ListChanged con l'enumerazione ItemAdded una seconda volta in questa riga indica che l'elemento è ora una riga normale (non in nuovo stato).Raising the ListChanged event with the ItemAdded enumeration a second time on this row indicates that the item is now a normal row (not in new state).

Si applica a