ListChangedEventArgs 類別

定義

提供 ListChanged 事件的資料。Provides data for the ListChanged event.

public ref class ListChangedEventArgs : EventArgs
public class ListChangedEventArgs : EventArgs
type ListChangedEventArgs = class
    inherit EventArgs
Public Class ListChangedEventArgs
Inherits EventArgs
繼承
ListChangedEventArgs

範例

下列程式碼範例示範如何使用這個類型。The following code example demonstrates the use of this type. 在此範例中,事件處理常式會報告 BindingSource.ListChanged 事件的發生。In the example, an event handler reports on the occurrence of the BindingSource.ListChanged event. 此報表可協助您瞭解事件發生的時間,並可協助您進行調試。This report helps you to learn when the event occurs and can assist you in debugging. 若要報告多個事件或經常發生的事件,請考慮使用 Console.WriteLine 取代 MessageBox.Show,或將訊息附加到多行 TextBoxTo report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

若要執行範例程式碼,請將它貼入專案,其中包含名為 BindingSource1BindingSource 類型的實例。To run the example code, paste it into a project that contains an instance of type BindingSource named BindingSource1. 然後確定事件處理常式與 BindingSource.ListChanged 事件相關聯。Then ensure that the event handler is associated with the BindingSource.ListChanged event.

private void BindingSource1_ListChanged(Object sender, ListChangedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ListChangedType", e.ListChangedType );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "NewIndex", e.NewIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "OldIndex", e.OldIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "PropertyDescriptor", e.PropertyDescriptor );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ListChanged Event" );
}
Private Sub BindingSource1_ListChanged(sender as Object, e as ListChangedEventArgs) _ 
     Handles BindingSource1.ListChanged

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ListChangedType", e.ListChangedType)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "NewIndex", e.NewIndex)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "OldIndex", e.OldIndex)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "PropertyDescriptor", e.PropertyDescriptor)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"ListChanged Event")

End Sub

備註

IBindingList 中的資料變更時,就會引發 ListChanged 事件。A ListChanged event is raised when the data in an IBindingList changes.

NewIndex 屬性會指出已新增、變更或刪除之專案的索引。The NewIndex property indicates the index of the item that was added, changed, or deleted. 如果專案已移動,NewIndex 屬性會指出專案的新位置,而 OldIndex 屬性會指出舊的位置。If an item was moved, the NewIndex property indicates the new location of the item and the OldIndex property indicates the old location.

如果只有一個專案受變更影響,則 OldIndex 屬性值為-1。If only one item is affected by a change, the OldIndex property value is -1.

建構函式

ListChangedEventArgs(ListChangedType, Int32)

指定變更類型和受影響項目的索引,初始化 ListChangedEventArgs 類別的新執行個體。Initializes a new instance of the ListChangedEventArgs class given the type of change and the index of the affected item.

ListChangedEventArgs(ListChangedType, Int32, Int32)

指定變更類型和已移動項目的新舊索引,初始化 ListChangedEventArgs 類別的新執行個體。Initializes a new instance of the ListChangedEventArgs class given the type of change and the old and new index of the item that was moved.

ListChangedEventArgs(ListChangedType, Int32, PropertyDescriptor)

指定變更類型、受影響項目的索引和描述受影響項目的 ListChangedEventArgs,初始化 PropertyDescriptor 類別的新執行個體。Initializes a new instance of the ListChangedEventArgs class given the type of change, the index of the affected item, and a PropertyDescriptor describing the affected item.

ListChangedEventArgs(ListChangedType, PropertyDescriptor)

指定變更類型和受影響的 ListChangedEventArgs,初始化 PropertyDescriptor 類別的新執行個體。Initializes a new instance of the ListChangedEventArgs class given the type of change and the PropertyDescriptor affected.

屬性

ListChangedType

取得變更類型。Gets the type of change.

NewIndex

取得受變更影響之項目的索引。Gets the index of the item affected by the change.

OldIndex

取得已移動項目的舊索引。Gets the old index of an item that has been moved.

PropertyDescriptor

取得已加入、變更或刪除的 PropertyDescriptorGets the PropertyDescriptor that was added, changed, or deleted.

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(繼承來源 Object)
GetHashCode()

作為預設雜湊函數。Serves as the default hash function.

(繼承來源 Object)
GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(繼承來源 Object)

適用於

另請參閱