BindingManagerBase.BindingComplete イベント

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

BindingManagerBase.BindingComplete イベント

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

データ バインディング操作の完了時に発生します。

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

Visual Basic (宣言)

Public Event BindingComplete As
 BindingCompleteEventHandler

Visual Basic (使用法)

Dim instance As BindingManagerBase
Dim handler As BindingCompleteEventHandler

AddHandler instance.BindingComplete, handler

C#

public event BindingCompleteEventHandler BindingComplete

C++

public:
event BindingCompleteEventHandler^ BindingComplete {
    void add (BindingCompleteEventHandler^ value);
    void remove (BindingCompleteEventHandler^ value);
}

J#

/** @event */
public void add_BindingComplete (BindingCompleteEventHandler
 value)

/** @event */
public void remove_BindingComplete (BindingCompleteEventHandler
 value)

JScript

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

解説

BindingComplete イベントは、データ バインディング操作の完了後に発生します。データ バインディング操作には、次の操作が含まれます。

• データ ソースからバインド コントロールのプロパティに情報をプッシュします。

• バインド コントロールから、関連付けられたデータ ソースに情報をプルします。

このイベントはバインディング操作の完了ステータスに関係なく発生しますが、このステータスは、イベントに関連付けられた BindingCompleteEventArgs パラメータの BindingCompleteState プロパティを調べることで確認できます。BindingCompleteEventArgs には、エラーや例外に関する情報が格納される場合もあります。たとえば、データ ソースから DateTimePicker コントロールに null 値をプッシュしようとするバインディング操作では、例外が生成されます。これは、DateTime には null 参照 (Visual Basic では Nothing) を設定できないためです。この場合、バインディング操作は正常に完了しませんが、BindingComplete イベントが発生し、このイベントには失敗したバインディング操作に関する情報が格納されます。

プラットフォーム

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

参照

関連項目
BindingManagerBase クラス
BindingManagerBase メンバ
System.Windows.Forms 名前空間
OnBindingComplete
BindingCompleteEventArgs クラス
BindingManagerBase.Bindings プロパティ
SuspendBinding
ResumeBinding
UpdateIsBinding