Control.RaiseBubbleEvent メソッド

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

Control.RaiseBubbleEvent メソッド

イベントのソースおよびその情報をコントロールの親に割り当てます。

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

Visual Basic (宣言)

Protected Sub RaiseBubbleEvent ( _
    source As Object, _
    args As EventArgs _
)

Visual Basic (使用法)

Dim source As Object
Dim args As EventArgs

Me.RaiseBubbleEvent(source, args)

C#

protected void RaiseBubbleEvent (
    Object source,
    EventArgs args
)

C++

protected:
void RaiseBubbleEvent (
    Object^ source, 
    EventArgs^ args
)

J#

protected void RaiseBubbleEvent (
    Object source, 
    EventArgs args
)

JScript

protected function RaiseBubbleEvent (
    source : Object, 
    args : EventArgs
)

パラメータ

source

イベントのソース。

args

イベント データを格納している EventArgs オブジェクト。

解説

Repeater、DataList、DataGrid の各 Web コントロールなどの ASP.NET サーバー コントロールには、イベントを発生させる子コントロールを格納できます。たとえば、DataGrid コントロールの各行に、テンプレートによって動的に作成された 1 つ以上のボタンを格納できます。各ボタンが個別にイベントを発生させるのではなく、入れ子になったコントロールからのイベントは "バブル イベント" になります。つまり、それらのイベントは、コントロールの親に送信されます。親はパラメータ値を使用して ItemCommand と呼ばれる汎用的なイベントを順番に発生させます。これらの値を使用すると、元のイベントを発生させた個別のコントロールを確認できます。この単一イベントに応答することによって、子コントロールのために個別のイベント処理メソッドを書き込む必要がなくなります。

このメソッドはオーバーライドできませんが、OnBubbleEvent メソッドをオーバーライドすることによって、作成したコントロールでバブル イベントを処理または発生させることができます。

使用例

カスタム クラス ChildControl を作成し、Button.OnClick メソッドをオーバーライドして、その親の ASP.NET サーバー コントロールに Button.Click イベントを送る RaiseBubbleEvent メソッドを呼び出す方法を次のコード例に示します。ChildControl のインスタンスが含まれる ASP.NET ページのボタンをユーザーがクリックすると、その ChildControl のインスタンスが含まれる親コントロールで OnBubbleEvent メソッドが呼び出され、そのページに "The ChildControl class OnClick method is called" という文字列が書き込まれます。

Visual Basic

Public Class ChildControl
   Inherits Button
   
   <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand,
 Name:="FullTrust")> _
   Protected Overrides Sub
 OnClick(e As EventArgs)
      MyBase.OnClick(e)
      Context.Response.Write("<br><br>ChildControl's
 OnClick called.")
      ' Bubble this event to parent.
      RaiseBubbleEvent(Me, e)
   End Sub 'OnClick
End Class 'ChildControl 

C#

public class ChildControl : Button
{
   [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand,
 Name="FullTrust")] 
   protected override void OnClick(EventArgs
 e) 
   {
      base.OnClick(e);
      Context.Response.Write("<br><br>ChildControl's OnClick called.");
      // Bubble this event to parent.
      RaiseBubbleEvent(this, e);
   }

J#

public class ChildControl extends Button
{
    protected void OnClick(EventArgs e)
    {
        super.OnClick(e);
        get_Context().get_Response().Write("<br><br>ChildControl's
 OnClick"
            + " called.");
        // Bubble this event to parent.
        RaiseBubbleEvent(this, e);
    } //OnClick

プラットフォーム

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、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
OnBubbleEvent