ListChangedEventArgs 類別

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

來源:

ListChangedEventArgs.cs

提供 ListChanged 事件的數據。

public ref class ListChangedEventArgs : EventArgs

public class ListChangedEventArgs : EventArgs

type ListChangedEventArgs = class
    inherit EventArgs

Public Class ListChangedEventArgs
Inherits EventArgs

繼承

Object

EventArgs

ListChangedEventArgs

範例

下列程式代碼範例示範此類型的用法。 在此範例中，事件處理程式會報告發生 BindingSource.ListChanged 事件。 此報告可協助您瞭解事件發生的時間，並協助您進行偵錯。 若要回報多個事件或經常發生的事件，請考慮將 MessageBox.Show 取代為 Console.WriteLine，或將訊息附加至多行 TextBox。

若要執行範例程式代碼，請將它貼入專案，其中包含名為 BindingSource1BindingSource 類型的實例。 然後確定事件處理程式與 BindingSource.ListChanged 事件相關聯。

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 事件。

NewIndex 屬性表示已新增、變更或刪除之專案的索引。 如果移動專案，NewIndex 屬性會指出專案的新位置，而 OldIndex 屬性則表示舊位置。

如果只有一個專案受到變更的影響，則 OldIndex 屬性值為 -1。

建構函式

ListChangedEventArgs(ListChangedType, Int32, Int32)	指定變更類型以及已移動之專案的舊索引，初始化 ListChangedEventArgs 類別的新實例。
ListChangedEventArgs(ListChangedType, Int32, PropertyDescriptor)	指定變更類型、受影響專案的索引，以及描述受影響專案的 PropertyDescriptor，初始化 ListChangedEventArgs 類別的新實例。
ListChangedEventArgs(ListChangedType, Int32)	指定變更類型和受影響專案的索引，初始化 ListChangedEventArgs 類別的新實例。
ListChangedEventArgs(ListChangedType, PropertyDescriptor)	指定變更類型和受影響的 PropertyDescriptor，初始化 ListChangedEventArgs 類別的新實例。

屬性

ListChangedType	取得變更的類型。
NewIndex	取得受變更影響之專案的索引。
OldIndex	取得已移動之專案的舊索引。
PropertyDescriptor	取得已新增、變更或刪除的 PropertyDescriptor。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

另請參閱

• IBindingList
• 使用 DataView 事件