BindingList<T>.RaiseListChangedEvents 属性

定义

获取或设置一个值,该值指示在列表中添加或移除项时是否会引发 ListChanged 事件。Gets or sets a value indicating whether adding or removing items within the list raises ListChanged events.

public:
 property bool RaiseListChangedEvents { bool get(); void set(bool value); };
public bool RaiseListChangedEvents { get; set; }
member this.RaiseListChangedEvents : bool with get, set
Public Property RaiseListChangedEvents As Boolean

属性值

如果添加或移除项时引发 ListChanged 事件,则为 true;否则为 falsetrue if adding or removing items raises ListChanged events; otherwise, false. 默认值为 trueThe default is true.

示例

下面的代码示例演示如何使用 RaiseListChangedEvents 方法。The following code example demonstrates how use the RaiseListChangedEvents method. 有关完整示例,请参阅 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));
    }
' Declare a new BindingListOfT with the Part business object.
Private WithEvents listOfParts As BindingList(Of Part)

Private Sub InitializeListOfParts()

    ' Create the new BindingList of Part type.
    listOfParts = New BindingList(Of 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))

End Sub

注解

如果希望在列表中禁止显示 ListChanged 事件,请将 RaiseListChangedEvents 属性设置为 "false"。Set the RaiseListChangedEvents property to false if you wish to suppress ListChanged events from occurring on the list.

适用于