Page.RegisterRequiresRaiseEvent メソッドとは何？わかりやすく解説 Weblio辞書

.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)

public virtual void RegisterRequiresRaiseEvent
 (
    IPostBackEventHandler control
)

C++

public:
virtual void RegisterRequiresRaiseEvent (
    IPostBackEventHandler^ control
)

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

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);
}

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