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

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

索引トップ用語の索引ランキング

Page.RegisterRequiresPostBack メソッド

コントロールを、ページがサーバーにポストバックされたときにポストバック処理を必要とするコントロールとして登録します。

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

Visual Basic (宣言)

Public Sub RegisterRequiresPostBack ( _
    control As Control _
)

Visual Basic (使用法)

Dim instance As Page
Dim control As Control

instance.RegisterRequiresPostBack(control)

public void RegisterRequiresPostBack (
    Control control
)

C++

public:
void RegisterRequiresPostBack (
    Control^ control
)

public void RegisterRequiresPostBack (
    Control control
)

JScript

public function RegisterRequiresPostBack (
    control : Control
)

パラメータ

control: 登録するコントロール。

例外

例外の種類	条件
HttpException	登録するコントロールが IPostBackDataHandler インターフェイスを実装していません。

解説

登録されるコントロールは、IPostBackDataHandler インターフェイスを実装する必要があります。実装しない場合は、HttpException が発生します。コントロールによって実装された場合、IPostBackDataHandler インターフェイスにより、データのポストバックと、ポストバックデータの変更イベントを発生させることが可能になります。サーバーコントロールのイベントモデルの詳細については、「ASP.NET Web サーバーコントロールのイベントモデル」を参照してください。

ページの有効期間の Page_PreRender イベントで、またはこのイベントの前に、コントロールをページに登録します。

使用例

RegisterRequiresPostBack メソッドを使用して、myTextBox テキストボックスコントロールを、このテキストボックスに関連付けられたコードを実行する前にポストバックすることを要求するコード例を次に示します。TextBox コントロールは、IPostBackDataHandler インターフェイスを実装しています。

Visual Basic

Sub Text_Change(ByVal sender As
 Object, ByVal e As EventArgs)
  myLabel.Text = "<b>Welcome " + myTextBox.Text
 + " to ASP.NET</b>"
End Sub 'Text_Change

Protected Sub Page_PreRender(ByVal
 sender As Object, ByVal
 e As System.EventArgs)
  Me.RegisterRequiresPostBack(myTextBox)
End Sub

protected void Text_Change(object sender, EventArgs
 e)
{
  myLabel.Text = "<b>Welcome " + myTextBox.Text + " to ASP.NET</b>";
}

protected void Page_PreRender(object sender,
 EventArgs e)
{
  this.RegisterRequiresPostBack(myTextBox);
}

void Text_Change(Object sender, EventArgs e)
{
  myLabel.set_Text("<b>Welcome " + myTextBox.get_Text()
      + " to ASP.NET</b>");
}

void Page_Load(Object sender, EventArgs e)
{
  this.RegisterRequiresPostBack(myTextBox);
}