IBindingList.AddNew Metodo

Definizione

Consente di aggiungere un nuovo elemento all'elenco.

public object AddNew ();
public object? AddNew ();

Restituisce

Elemento aggiunto all'elenco.

Eccezioni

Commenti

Questo metodo è supportato solo se AllowNew è true; in caso contrario, viene generata un'eccezione NotSupportedException .

L'implementazione di questo metodo significa che l'elenco IBindingList deve comprendere il tipo di oggetti da aggiungere all'elenco e deve comprendere come creare una nuova istanza di tale tipo. Ad esempio, se si dispone di una raccolta di myCustomer oggetti, il AddNew metodo deve aggiungere un nuovo myCustomer oggetto all'elenco.

Nota

Se gli oggetti in questo elenco implementano l'interfaccia IEditableObject , chiamare il CancelEdit metodo deve rimuovere un oggetto, non aggiungerlo all'elenco, quando l'oggetto è stato creato usando il AddNew metodo . L'oggetto deve essere aggiunto all'elenco solo quando viene chiamato il IEditableObject.EndEdit metodo . Pertanto, è necessario sincronizzare attentamente l'oggetto e l'elenco.

Quando questo metodo viene chiamato, è necessario generare un ListChanged evento con l'enumerazione che contiene l'indice ItemAdded appropriato. La riga aggiunta si trova in uno stato in cui premere ESC su un DataGridView controllo può rimuovere la nuova riga. La generazione dell'evento con l'enumerazione ListChangedItemAdded una seconda volta in questa riga indica che l'elemento è ora una riga normale (non nello stato nuovo).

Si applica a

Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1