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 Guide pratique pour personnaliser l’ajout d’éléments avec le 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 l’ajout d’un nouvel objet à la liste sous-jacente représentée par la List propriété . Cet événement est déclenché après l’appel de la AddNew méthode, mais avant que le nouvel élément ne soit créé et ajouté à la liste sous-jacente. En gérant cet événement, le programmeur peut fournir un comportement de création et d’insertion d’élément personnalisé sans être forcé à 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, sinon une exception se produit. Vous ne pouvez pas définir la NewObject propriété lorsqu’elle est liée à un DataView ou DataTable parce que vous ne pouvez pas ajouter un nouveau DataRowView à la liste.
Pour plus d’informations sur la fourniture de fonctionnalités personnalisées de nouvel élément, consultez la AddNew méthode . Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.
