BindingList<T> Constructor ()

 
System_CAPS_noteNote

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

Initializes a new instance of the BindingList<T> class using default values.

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

public BindingList()

The following table shows initial property values for an instance of BindingList<T> class.

Property

Initial Value

AllowEdit

true

AllowNew

true if the list type has a default constructor; otherwise, false.

AllowRemove

true

RaiseListChangedEvents

true

The following code example demonstrates how to construct a new BindingList<T>. For the complete example, see the BindingList<T> class overview topic.

// Declare a new BindingListOfT with the Part business object.
BindingList<Part> listOfParts; 
private void InitializeListOfParts()
{
    // Create the new BindingList of Part type.
    listOfParts = new BindingList<Part>();

    // Allow new parts to be added, but not removed once committed.        
    listOfParts.AllowNew = true;
    listOfParts.AllowRemove = false;

    // Raise ListChanged events when new parts are added.
    listOfParts.RaiseListChangedEvents = true;

    // Do not allow parts to be edited.
    listOfParts.AllowEdit = false;

    // Add a couple of parts to the list.
    listOfParts.Add(new Part("Widget", 1234));
    listOfParts.Add(new Part("Gadget", 5647));
}

.NET Framework
Available since 2.0
Return to top
Show: