Page.RegisterRequiresPostBack(Control) メソッド

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

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

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

登録するコントロール。

例外

HttpException

登録するコントロールが 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 Forms」を参照してください。

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

こちらもご覧ください

• IsPostBack
• IPostBackDataHandler
• ASP.NET ページのライフサイクルの概要
• ASP.NET サーバー コントロール イベント モデル