BindingSource.AddingNew Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit avant l’ajout d’un élément à la liste sous-jacente.
public:
event System::ComponentModel::AddingNewEventHandler ^ AddingNew;public event System.ComponentModel.AddingNewEventHandler AddingNew;public event System.ComponentModel.AddingNewEventHandler? AddingNew;member this.AddingNew : System.ComponentModel.AddingNewEventHandler Public Custom Event AddingNew As AddingNewEventHandler Type d'événement
Exceptions
NewObject n’est pas le même type que le type contenu dans la liste.
Exemples
L’exemple de code suivant utilise un BindingSource composant pour lier une liste à un DataGridView contrôle. Les nouveaux éléments sont ajoutés à la liste par le gestionnaire d’événements AddingNew . Cet exemple de code fait partie d’un exemple plus large fourni dans How to : Customize Item Addition with the 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
Remarques
L’événement AddingNew se produit avant qu’un nouvel objet soit ajouté à la liste sous-jacente représentée par la List propriété. Cet événement est déclenché une fois la AddNew méthode appelée, mais avant la création et l’ajout de l’élément à la liste sous-jacente. En gérant cet événement, le programmeur peut fournir un comportement personnalisé de création et d’insertion d’éléments sans être obligé de dériver de la BindingSource classe. Pour ce faire, dans le gestionnaire d’événements, définissez la NewObject propriété du System.ComponentModel.AddingNewEventArgs paramètre sur le nouvel élément. Le nouvel objet créé dans l’événement AddingNew doit être du même type que le type contenu dans la liste ou une exception se produit. Vous ne pouvez pas définir la NewObject propriété lorsqu’elle est liée à une DataView ou DataTable parce que vous ne pouvez pas ajouter une nouvelle DataRowView à la liste.
Pour plus d’informations sur la fourniture de nouvelles fonctionnalités d’élément personnalisées, consultez la AddNew méthode. Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.
