AddingNewEventArgs Classe

Définition

Fournit des données pour l'événement AddingNew.Provides data for the AddingNew event.

public ref class AddingNewEventArgs : EventArgs
public class AddingNewEventArgs : EventArgs
type AddingNewEventArgs = class
    inherit EventArgs
Public Class AddingNewEventArgs
Inherits EventArgs
Héritage
AddingNewEventArgs

Exemples

L’exemple de code suivant montre comment utiliser la classe AddingNewEventArgs pour gérer l’événement BindingSource.AddingNew.The following code example demonstrates how to use the AddingNewEventArgs class to handle the BindingSource.AddingNew event. Cet exemple de code fait partie d’un exemple plus complet fourni dans Comment : personnaliser l’ajout d’éléments avec le BindingSource Windows Forms.This code example is part of a larger example provided in 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

La classe AddingNewEventArgs fournit des données pour l’événement BindingSource.AddingNew, qui signale qu’un élément est sur le point d’être ajouté à une collection.The AddingNewEventArgs class provides data for the BindingSource.AddingNew event, which signals that an item is about to be added to a collection. L’événement donne au programmeur, dans le gestionnaire d’événements AddingNewEventHandler, la possibilité de fournir le nouvel objet en affectant à la propriété NewObject la valeur de ce nouvel élément.The event gives the programmer, within the event handler AddingNewEventHandler, the option of supplying the new object by setting the NewObject property to this new item. Si cette propriété n’est pas définie, la collection utilise généralement le constructeur sans paramètre du type approprié pour construire un nouvel élément.If this property is not set, the collection will typically use the parameterless constructor of the appropriate type to construct a new item. Dans les deux cas, le nouvel élément est ajouté à la collection.In either case, the new item will be added to the collection.

Si la collection implémente également l’interface ICancelAddNew, l’élément sera ajouté de façon provisionnée, en attendant une validation ou une restauration ultérieure.If the collection also implements the ICancelAddNew interface, the item will be provisionally added, waiting a subsequent commit or rollback.

Cet événement est couramment utilisé dans les scénarios de liaison de données, dans des classes telles que System.Windows.Forms.BindingSource et System.ComponentModel.BindingList<T>.This event is commonly used in data-binding scenarios, within classes such as System.Windows.Forms.BindingSource and System.ComponentModel.BindingList<T>.

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.For more information about how to handle events, see Handling and Raising Events.

Constructeurs

AddingNewEventArgs()

Initialise une nouvelle instance de la classe AddingNewEventArgs sans paramètre.Initializes a new instance of the AddingNewEventArgs class using no parameters.

AddingNewEventArgs(Object)

Initialise une nouvelle instance de la classe AddingNewEventArgs à l'aide de l'objet spécifié en tant que nouvel élément.Initializes a new instance of the AddingNewEventArgs class using the specified object as the new item.

Propriétés

NewObject

Obtient ou définit l'objet à ajouter à la liste de liaison.Gets or sets the object to be added to the binding list.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi