Page.RegisterRequiresRaiseEvent メソッド

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

Page.RegisterRequiresRaiseEvent メソッド

ASP.NET サーバー コントロールが Page オブジェクトで処理されたときに、このコントロールをイベントの発生を要求するコントロールとして登録します。

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

Visual Basic (宣言)

Public Overridable Sub RegisterRequiresRaiseEvent
 ( _
    control As IPostBackEventHandler _
)

Visual Basic (使用法)

Dim instance As Page
Dim control As IPostBackEventHandler

instance.RegisterRequiresRaiseEvent(control)

C#

public virtual void RegisterRequiresRaiseEvent
 (
    IPostBackEventHandler control
)

C++

public:
virtual void RegisterRequiresRaiseEvent (
    IPostBackEventHandler^ control
)

J#

public void RegisterRequiresRaiseEvent (
    IPostBackEventHandler control
)

JScript

public function RegisterRequiresRaiseEvent
 (
    control : IPostBackEventHandler
)

パラメータ

control

登録するコントロール。

解説

1 つのページ要求について登録できるサーバー コントロールは 1 つだけです。フォームのポスト データ内にコントロール ID が含まれていないコントロールの場合は、RegisterRequiresRaiseEvent を使用する必要があります。また、登録されるコントロールは、IPostBackEventHandler インターフェイスを実装する必要があります。

使用例

RegisterRequiresRaiseEvent メソッドを使用して、イベントの発生を要求するコントロールとしてButton Web サーバー コントロールを登録する方法を次のコード例に示します。最初の Button コントロールを登録したら、コード内で宣言されている 2 個目の Button コントロールが最初のボタンのクリック イベントの結果をページにポストバックするようにできます。

Visual Basic

  Sub DisplayUserName(Sender As Object,
 e As EventArgs) 
     Response.Write("Welcome to " + Server.HtmlEncode(userName.Text))
  End Sub

 Sub MyRaiseEvent(Sender As Object,
 e As EventArgs)
     'Raises a post back event for a control.
      Me.RaisePostBackEvent(userButton, "")
 End Sub 
  
  Sub Page_Load(Sender As Object,
 e As EventArgs)
    
    'Registers a control as one that requires postback handling
    Me.RegisterRequiresRaiseEvent(userButton)
End Sub

C#

void DisplayUserName(Object sender, EventArgs ea) 
{
   Response.Write("Welcome to " + Server.HtmlEncode(userName.Text));
}
void RaiseEvent(Object sender, EventArgs ea)
{
   // Raise a post back event for a control.
   this.RaisePostBackEvent(userButton, "");
}
void Page_Load(Object sender, EventArgs ea)
{
   // Register a control as one that requires postback handling.
   this.RegisterRequiresRaiseEvent(userButton);
}

J#

void DisplayUserName(Object sender, EventArgs ea) 
{
    get_Response().Write("Welcome to " 
        + get_Server().HtmlEncode(userName.get_Text()));
} //DisplayUserName
      
void RaiseEvent(Object sender, EventArgs ea)
{
    // Raise a post back event for a control.
    this.RaisePostBackEvent(userButton, "");
} //RaiseEvent
      
void Page_Load(Object sender, EventArgs ea)
{
    // Register a control as one that requires postback handling.
    this.RegisterRequiresRaiseEvent(userButton);
} //Page_Load    

プラットフォーム

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

参照

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