Page.RegisterRequiresPostBack(Control) Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zaregistruje ovládací prvek jako ovládací prvek, který vyžaduje zpracování postback, když se stránka publikuje zpět na server.

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)

Parametry

control: Control

Ovládací prvek, který se má zaregistrovat.

Výjimky

HttpException

Ovládací prvek pro registraci neimplementuje IPostBackDataHandler rozhraní.

Příklady

Následující příklad kódu používá metodu RegisterRequiresPostBack k vyžadování ovládacího prvku textového pole , k myTextBoxodeslání zpět před jakýkoli kód přidružený k textovému poli může spustit. TextBox ovládací prvky implementují IPostBackDataHandler rozhraní.

Důležité

V tomto příkladu je textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

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

Poznámky

Ovládací prvek, který se má zaregistrovat, musí implementovat IPostBackDataHandler rozhraní nebo HttpException je vyvolán. Když je ovládací prvek implementovaný, IPostBackDataHandler rozhraní umožňuje zpracování dat po zpětném odeslání a vyvolání všech událostí změněných dat post back. Další informace o modelu událostí řízení serveru najdete v tématu ASP.NET Web Forms Model událostí řízení serveru.

Zaregistrujte ovládací prvky na stránce nebo před Page_PreRender událostí životního cyklu stránky.

Platí pro