BindingSource.ListChanged イベント

.NET Framework クラス ライブラリ リファレンス

BindingSource.ListChanged イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

基底のリストまたはリスト内の項目が変更された場合に発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event ListChanged As
 ListChangedEventHandler

Visual Basic (使用法)

Dim instance As BindingSource
Dim handler As ListChangedEventHandler

AddHandler instance.ListChanged, handler

C#

public event ListChangedEventHandler ListChanged

C++

public:
virtual event ListChangedEventHandler^ ListChanged {
    void add (ListChangedEventHandler^ value) sealed;
    void remove (ListChangedEventHandler^ value) sealed;
}

J#

/** @event */
public final void add_ListChanged (ListChangedEventHandler
 value)

/** @event */
public final void remove_ListChanged (ListChangedEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

ListChanged イベントは、List プロパティで表される基底のリストのメンバシップまたはメタデータが変更されたときに発生します。たとえば、項目が追加、削除、または移動されたり、DataSource プロパティや DataMember プロパティが変更されたりしたときに発生します。このイベントが発生しても、Sort プロパティと Filter プロパティの値は保持されます。

このイベントをまったく発生させないようにするには、RaiseListChangedEvents プロパティを false に設定します。イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

次のコード例では、BindingSource コンポーネントの ListChanged イベントを処理して、BindingSource コンポーネントの基底のリストが変更されたことを検出する方法を示します。

Visual Basic

' This event handler detects changes in the BindingSource 
' list or changes to items within the list.
Private Sub customersBindingSource_ListChanged(ByVal
 sender As Object, _
    ByVal e As ListChangedEventArgs) Handles
 customersBindingSource.ListChanged

    status.Text = e.ListChangedType.ToString()
End Sub

C#

// This event handler detects changes in the BindingSource 
// list or changes to items within the list.
void customersBindingSource_ListChanged(
    object sender,
    ListChangedEventArgs e)
{
    status.Text = e.ListChangedType.ToString();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
BindingSource クラス
BindingSource メンバ
System.Windows.Forms 名前空間
BindingSource.List プロパティ
OnListChanged
BindingSource.RaiseListChangedEvents プロパティ
System.ComponentModel.ListChangedType
BindingSource.CurrentChanged イベント
BindingSource.CurrentItemChanged イベント