AddingNewEventArgs.NewObject Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets the object to be added to the binding list.

Namespace:   System.ComponentModel
Assembly:  System (in System.dll)

public object NewObject { get; set; }

Property Value

Type: System.Object

The Object to be added as a new item to the associated collection.

If the NewObject property is set to null, it indicates that the collection is to take the standard action, which typically entails creating an object of the appropriate type using its default constructor, and then adding it to the collection.

The following code example demonstrates how to use the AddingNewEventArgs class to handle the BindingSource.AddingNew event. 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 customersBindingSource_AddingNew(
    object sender, 
    AddingNewEventArgs e)
    e.NewObject = DemoCustomer.CreateNewCustomer();

.NET Framework
Available since 2.0
Return to top