BindingSource.AddingNew Gebeurtenis
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.
Vindt plaats voordat een item wordt toegevoegd aan de onderliggende lijst.
public:
event System::ComponentModel::AddingNewEventHandler ^ AddingNew;public event System.ComponentModel.AddingNewEventHandler AddingNew;member this.AddingNew : System.ComponentModel.AddingNewEventHandler Public Custom Event AddingNew As AddingNewEventHandler Gebeurtenistype
Uitzonderingen
NewObject is niet hetzelfde type als het type in de lijst.
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.
// This event handler provides custom item-creation behavior.
void OnCustomersBindingSourceAddingNew(Object^ sender,
AddingNewEventArgs^ e)
{
e->NewObject = DemoCustomer::CreateNewCustomer();
}
// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
object sender,
AddingNewEventArgs e)
{
e.NewObject = DemoCustomer.CreateNewCustomer();
}
' This event handler provides custom item-creation behavior.
Private Sub customersBindingSource_AddingNew( _
ByVal sender As Object, _
ByVal e As AddingNewEventArgs) _
Handles customersBindingSource.AddingNew
e.NewObject = DemoCustomer.CreateNewCustomer()
End Sub
Opmerkingen
De AddingNew gebeurtenis treedt op voordat een nieuw object wordt toegevoegd aan de onderliggende lijst die wordt vertegenwoordigd door de List eigenschap. Deze gebeurtenis wordt geactiveerd nadat de AddNew methode is aangeroepen, maar voordat het nieuwe item wordt gemaakt en toegevoegd aan de onderliggende lijst. Door deze gebeurtenis af te handelen, kan de programmeur aangepast gedrag bieden voor het maken en invoegen van items zonder dat de programmeur wordt gedwongen om af te leiden van de BindingSource klasse. 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. U kunt de NewObject eigenschap niet instellen als deze is gebonden aan een DataView of DataTable omdat u geen nieuwe DataRowView aan de lijst kunt toevoegen.
Zie de AddNew methode voor meer informatie over het leveren van aangepaste nieuwe itemfunctionaliteit. Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.