FormView.OnBubbleEvent メソッド

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

FormView.OnBubbleEvent メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

コントロールの下位階層から渡されたイベントを処理します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overrides Function
 OnBubbleEvent ( _
    source As Object, _
    e As EventArgs _
) As Boolean

Visual Basic (使用法)

Dim source As Object
Dim e As EventArgs
Dim returnValue As Boolean

returnValue = Me.OnBubbleEvent(source, e)

C#

protected override bool OnBubbleEvent (
    Object source,
    EventArgs e
)

C++

protected:
virtual bool OnBubbleEvent (
    Object^ source, 
    EventArgs^ e
) override

J#

protected boolean OnBubbleEvent (
    Object source, 
    EventArgs e
)

JScript

protected override function OnBubbleEvent (
    source : Object, 
    e : EventArgs
) : boolean

パラメータ

source

イベントのソース。

e

イベント データを格納している EventArgs。

戻り値
イベントをさらにコントロールの上位階層に渡す必要がある場合は true。それ以外の場合は false。

解説

Control.OnBubbleEvent メソッドは、RaiseBubbleEvent メソッドによってコントロールの下位階層から渡されたイベントを必要に応じて処理するために、このコントロールで使用されます。このメソッドは、e パラメータに格納されている EventArgs オブジェクトのプロパティをチェックすることによって、イベントを処理するかどうかを確認します。イベントを処理する必要がある場合、このメソッドは、適切なアクションを実行します。それ以外のイベントは、無視され、コントロールの上位階層に渡されます。このメソッドは、戻り値を使用して、イベントをさらにコントロールの上位階層に渡すかどうかを指定します。

FormView コントロールは、このメソッドの基本実装をオーバーライドして、このコントロールが認識するボタンのいずれかがクリックされたときに適切なアクションを実行します。FormView コントロールが認識するコマンド ボタンの一覧を次の表に示します。

ボタン	Commandname 値	説明
Cancel	"Cancel"	操作をキャンセルし、ユーザーが入力した値を破棄する更新操作または挿入操作で使用します。FormView コントロールは、その後、DefaultMode プロパティで指定されたモードに戻ります。
Delete	"Delete"	表示されているレコードをデータ ソースから削除する削除操作で使用します。ItemDeleting イベントおよび ItemDeleted イベントを発生させます。
Edit	"Edit"	FormView コントロールを編集モードにする更新操作で使用します。EditItemTemplate プロパティで指定されたコンテンツがデータ行に表示されます。
Insert	"Insert"	ユーザーが入力した値を使用してデータ ソースに新規レコードを挿入する挿入操作で使用します。ItemInserting イベントおよび ItemInserted イベントを発生させます。
New	"New"	FormView コントロールを挿入モードにする挿入操作で使用します。InsertItemTemplate プロパティで指定されたコンテンツがデータ行に表示されます。
Page	"Page"	ページングを実行するページ行のボタンを表すページング操作で使用します。ページング操作を指定するには、ボタンの CommandArgument プロパティを "Next"、"Prev"、"First"、"Last"、または移動先のページのインデックスに設定します。PageIndexChanging イベントおよび PageIndexChanged イベントを発生させます。 メモ この種類のボタンは、通常、ページャ テンプレートでのみ使用されます。
Update	"Update"	更新操作で、ユーザーが入力した値を使用して、表示されているレコードをデータ ソースで更新するために使用します。ItemUpdating イベントおよび ItemUpdated イベントを発生させます。

このバージョンのこのメソッドでは、これらのいずれかのボタンが処理された場合に true を返します。イベント バブルの詳細については、「イベントとデリゲート」を参照してください。

継承時の注意 FormView クラスを拡張すると、このメソッドをオーバーライドして、独自のイベントを処理できます。必ず、戻り値を使用して、イベントをコントロールの上位階層に渡す必要があるかどうかを示してください。

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

関連項目
FormView クラス
FormView メンバ
System.Web.UI.WebControls 名前空間
Control.OnBubbleEvent
EventArgs
その他の技術情報
イベントとデリゲート