BindingSource.AddNew Metodo

public:
 virtual System::Object ^ AddNew();

public virtual object AddNew ();

public virtual object? AddNew ();

abstract member AddNew : unit -> obj
override this.AddNew : unit -> obj

Public Overridable Function AddNew () As Object

Restituisce

L'oggetto Object creato e aggiunto all'elenco.

Implementazioni

Eccezioni

Esempio

Nell'esempio di codice seguente viene usato un componente per associare un BindingSource elenco a un DataGridView controllo. I nuovi elementi vengono aggiunti all'elenco AddingNew dal gestore eventi. Questo esempio di codice fa parte di un esempio più grande fornito in Procedura: Personalizzare l'aggiunta dell'elemento con l'Windows Forms BindingSource.

private:
   
    void OnMainFormLoad(Object^ sender, EventArgs^ e)
    {
        // Add a DemoCustomer to cause a row to be displayed.
        this->customersBindingSource->AddNew();
          
        // Bind the BindingSource to the DataGridView 
        // control's DataSource.
        this->customersDataGridView->DataSource = 
            this->customersBindingSource;
    }

private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Add a DemoCustomer to cause a row to be displayed.
    this.customersBindingSource.AddNew();

    // Bind the BindingSource to the DataGridView 
    // control's DataSource.
    this.customersDataGridView.DataSource = 
        this.customersBindingSource;
}

Private Sub Form1_Load( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs)

    ' Add a DemoCustomer to cause a row to be displayed.
    Me.customersBindingSource.AddNew()

    ' Bind the BindingSource to the DataGridView 
    ' control's DataSource.
    Me.customersDataGridView.DataSource = Me.customersBindingSource

End Sub

Commenti

Il AddNew metodo aggiunge un nuovo elemento all'elenco List sottostante rappresentato dalla proprietà . Questo metodo configura la serie di azioni seguenti:

1. Il EndEdit metodo viene chiamato automaticamente per eseguire il commit di tutte le operazioni di modifica in sospeso.

2. L'evento AddingNew viene generato automaticamente. Questo evento può essere gestito a livello di codice per costruire il nuovo elemento. Questa operazione viene eseguita nel gestore eventi impostando la NewObject proprietà del System.ComponentModel.AddingNewEventArgs parametro sul nuovo elemento. Il nuovo oggetto creato nell'evento AddingNew deve essere dello stesso tipo del tipo contenuto nell'elenco o si verificherà un'eccezione.

   Se l'evento AddingNew non viene gestito e l'elenco sottostante è un IBindingListoggetto , la richiesta viene passata al metodo dell'elenco IBindingList.AddNew . Se l'elenco sottostante non è un IBindingListoggetto , l'elemento viene creato automaticamente tramite il relativo costruttore senza parametri pubblico. In entrambi i casi, il nuovo elemento viene aggiunto alla fine dell'elenco.

3. Il nuovo elemento viene aggiunto immediatamente all'elenco interno, a meno che l'origine dati non implementi l'interfaccia IEditableObject . In questo caso, il nuovo elemento non viene eseguito fino a quando non viene avviata una chiamata esplicita a o fino a ICancelAddNew.EndNew quando non viene avviata una nuova operazione di elenco. Prima di eseguire il commit, il nuovo elemento può essere eseguito il rollback chiamando CancelEdit, nel qual caso il nuovo elemento viene rimosso.

Questo metodo genera l'evento ListChanged .

Si applica a

Vedi anche

• AddNew()
• AddingNewEventArgs
• AddingNew
• AllowNew
• IBindingList