BindingSource.AddNew Metod

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

public virtual object AddNew();

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

Public Overridable Function AddNew () As Object

Returer

Det Object som skapades och lades till i listan.

Implementeringar

Undantag

Exempel

I följande kodexempel används en BindingSource komponent för att binda en lista till en DataGridView kontroll. Nya objekt läggs till i listan av AddingNew händelsehanteraren. Det här kodexemplet är en del av ett större exempel i Hur du: Anpassa objekttillägg med 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

Kommentarer

Metoden AddNew lägger till ett nytt objekt i den underliggande listan som representeras av egenskapen List . Den här metoden konfigurerar följande serie åtgärder:

1. Metoden EndEdit anropas automatiskt för att genomföra väntande redigeringsåtgärder.

2. Händelsen AddingNew aktiveras automatiskt. Den här händelsen kan hanteras programmatiskt för att skapa det nya objektet. Detta görs i händelsehanteraren genom att ange NewObject egenskapen för parametern System.ComponentModel.AddingNewEventArgs till det nya objektet. Det nya objektet som skapades i AddingNew händelsen måste vara av samma typ som den typ som finns i listan, annars inträffar ett undantag.

   Om händelsen AddingNew inte hanteras och den underliggande listan är en IBindingListskickas begäran till listans IBindingList.AddNew metod. Om den underliggande listan inte är en IBindingListskapas objektet automatiskt via den offentliga parameterlösa konstruktorn. I båda fallen läggs det nya objektet till i slutet av listan.

3. Det nya objektet läggs omedelbart till i den interna listan om inte datakällan implementerar IEditableObject gränssnittet. I det här fallet checkas inte det nya objektet in förrän ett explicit anrop till ICancelAddNew.EndNew görs eller tills en ny liståtgärd initieras. Innan det checkas in kan det nya objektet återställas genom att anropa CancelEdit, i vilket fall det nya objektet ignoreras.

Den här metoden genererar händelsen ListChanged .

Se även

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