IBindingList.AddNew Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consente di aggiungere un nuovo elemento all'elenco.
public:
System::Object ^ AddNew();public object AddNew ();public object? AddNew ();abstract member AddNew : unit -> objPublic Function AddNew () As ObjectRestituisce
Elemento aggiunto all'elenco.
Eccezioni
AllowNew è false.
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).
