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 インターフェイスを実装します。

Important

この例には、潜在的なセキュリティ上の脅威であるユーザー入力を受け入れるテキスト ボックスがあります。 既定では、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 イベントの前後に、コントロールをページに登録します。

適用対象

こちらもご覧ください