SqlConnection.StateChange イベント
接続の状態が変更したときに発生します。
Public Event StateChange As StateChangeEventHandler
[C#]
public event StateChangeEventHandler StateChange;
[C++]
public: __event StateChangeEventHandler* StateChange;
[JScript] JScript では、このクラスで定義されているイベントを処理できます。ただし、独自に定義することはできません。
イベント データ
イベント ハンドラが、このイベントに関連するデータを含む、StateChangeEventArgs 型の引数を受け取りました。次の StateChangeEventArgs プロパティには、このイベントの固有の情報が記載されます。
プロパティ | 説明 |
---|---|
CurrentState | 接続の新しい状態を取得します。イベントが発生したときは、接続オブジェクトが既に新しい状態になっています。 |
OriginalState | 接続の元の状態を取得します。 |
解説
StateChange イベントは、 State がクローズからオープン、またはオープンからクローズに変わるたびに発生します。 StateChange は、 SqlConnection が移行した直後に発生します。
StateChange イベント内でイベント ハンドラが例外をスローすると、その例外は、 Open メソッドまたは Close メソッドの呼び出し元に通知されます。
Close または Dispose を明示的に呼び出さない限り、 StateChange イベントは発生しません。詳細については、「 接続イベントの使用 」を参照してください。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
SqlConnection クラス | SqlConnection メンバ | System.Data.SqlClient 名前空間