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

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

Eccezioni

Commenti

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

L'implementazione di questo metodo significa IBindingList che l'elenco 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. Ad esempio, se si dispone di una raccolta myCustomer di oggetti, AddNew il metodo deve aggiungere un myCustomer nuovo oggetto 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 IEditableObject l'interfaccia, la CancelEdit chiamata al metodo deve rimuovere un oggetto, non aggiungerlo all'elenco, quando l'oggetto è stato creato AddNew usando il metodo.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 IEditableObject.EndEdit il metodo.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 ListChanged evento con l' ItemAdded enumerazione 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 si trova in uno stato in cui la nuova DataGridView riga può essere rimossa da ESC su un controllo.The added row is in a state where hitting Esc on a DataGridView control can remove the new row. La generazione ListChanged dell'evento con ItemAdded l'enumerazione una seconda volta in questa riga indica che l'elemento è ora una riga normale (non in stato nuovo).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