Page.RegisterRequiresPostBack(Control) メソッド

定義

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

public:
 void RegisterRequiresPostBack(System::Web::UI::Control ^ control);
public void RegisterRequiresPostBack (System.Web.UI.Control control);
member this.RegisterRequiresPostBack : System.Web.UI.Control -> unit
Public Sub RegisterRequiresPostBack (control As Control)

パラメーター

control
Control

登録するコントロール。

例外

登録するコントロールが IPostBackDataHandler インターフェイスを実装していません。

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

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、「スクリプトによる攻略の概要」を参照してください。

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

注釈

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

ページ ライフ サイクルのイベントの前後に、コントロールを Page_PreRender ページに登録します。

適用対象

こちらもご覧ください