RaiseListChangedEvents Property

BindingList<T>.RaiseListChangedEvents Property

 

Gets or sets a value indicating whether adding or removing items within the list raises ListChanged events.

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

public bool RaiseListChangedEvents { get; set; }

Property Value

Type: System.Boolean

true if adding or removing items raises ListChanged events; otherwise, false. The default is true.

Set the RaiseListChangedEvents property to false if you wish to suppress ListChanged events from occurring on the list.

The following code example demonstrates how use the RaiseListChangedEvents method. 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:
© 2016 Microsoft