Page.RegisterRequiresPostBack(Control) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロールを、ページがサーバーにポストバックされたときにポストバック処理を必要とするコントロールとして登録します。
public:
void RegisterRequiresPostBack(System::Web::UI::Control ^ control);public void RegisterRequiresPostBack (System.Web.UI.Control control);member this.RegisterRequiresPostBack : System.Web.UI.Control -> unitPublic 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 ページに登録します。
適用対象
こちらもご覧ください
.NET