BindingSource.AddNew Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u een nieuw item toe aan de onderliggende lijst.
public:
virtual System::Object ^ AddNew();public virtual object AddNew();public virtual object? AddNew();abstract member AddNew : unit -> obj
override this.AddNew : unit -> objPublic Overridable Function AddNew () As ObjectRetouren
De Object gemaakt en toegevoegd aan de lijst.
Implementeringen
Uitzonderingen
De eigenschap AllowNew is ingesteld op false.
– of –
Er is geen openbare parameterloze constructor gevonden voor het huidige itemtype.
Voorbeelden
In het volgende codevoorbeeld wordt een onderdeel gebruikt om een BindingSource lijst aan een DataGridView besturingselement te binden. Nieuwe items worden door de gebeurtenis-handler aan de AddingNew lijst toegevoegd. Dit codevoorbeeld maakt deel uit van een groter voorbeeld in Hoe u: Itemtoevoeging aanpassen met de 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
Opmerkingen
Met AddNew de methode wordt een nieuw item toegevoegd aan de onderliggende lijst die wordt vertegenwoordigd door de List eigenschap. Met deze methode stelt u de volgende reeks acties in:
De EndEdit methode wordt automatisch aangeroepen om bewerkingen die in behandeling zijn, door te voeren.
De AddingNew gebeurtenis wordt automatisch gegenereerd. Deze gebeurtenis kan programmatisch worden verwerkt om het nieuwe item te maken. Dit wordt bereikt in de gebeurtenis-handler door de NewObject eigenschap van de System.ComponentModel.AddingNewEventArgs parameter in te stellen op het nieuwe item. Het nieuwe object dat in de AddingNew gebeurtenis is gemaakt, moet van hetzelfde type zijn als het type in de lijst of er wordt een uitzondering opgetreden.
Als de AddingNew gebeurtenis niet wordt verwerkt en de onderliggende lijst een IBindingListis, wordt de aanvraag doorgegeven aan de methode van IBindingList.AddNew de lijst. Als de onderliggende lijst geen IBindingListis, wordt het item automatisch gemaakt via de openbare parameterloze constructor. In beide gevallen wordt het nieuwe item toegevoegd aan het einde van de lijst.
Het nieuwe item wordt onmiddellijk toegevoegd aan de interne lijst, tenzij de gegevensbron de IEditableObject interface implementeert. In dit geval wordt het nieuwe item pas doorgevoerd als er een expliciete aanroep wordt ICancelAddNew.EndNew gedaan of totdat een nieuwe lijstbewerking wordt gestart. Voordat het wordt doorgevoerd, kan het nieuwe item worden teruggedraaid door aan te roepen CancelEdit, in welk geval het nieuwe item wordt verwijderd.
Met deze methode wordt de ListChanged gebeurtenis gegenereerd.
