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, 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 che l' IBindingList 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 di myCustomer oggetti, il AddNew metodo deve aggiungere un nuovo myCustomer 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 l' IEditableObject interfaccia, la chiamata al CancelEdit metodo deve rimuovere un oggetto, non aggiungerlo all'elenco, quando l'oggetto è stato creato usando il AddNew 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 IEditableObject.EndEdit viene chiamato 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 DataGridView la nuova 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 dell' ListChanged evento con l' ItemAdded 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