Sdílet prostřednictvím


Page.RegisterRequiresPostBack(Control) Metoda

Definice

Zaregistruje ovládací prvek jako ovládací prvek, který vyžaduje zpracování zpětného odeslání stránky 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

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 , myTextBoxaby byl odeslán zpět před spuštěním jakéhokoli kódu přidruženého k textovému poli. TextBox ovládací prvky implementují IPostBackDataHandler rozhraní.

Důležité

Tento příklad obsahuje 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 uživatelský vstup neobsahuje skript nebo 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ána. Při implementaci ovládacím prvku IPostBackDataHandler rozhraní umožňuje zpracování dat po zpětném zálohování a vyvolání událostí změny dat po vrácení zpět. Další informace o modelu událostí ovládacího prvku serveru najdete v tématu ASP.NET Model událostí ovládacího prvku serveru Web Forms.

Zaregistrujte ovládací prvky se stránkou v události životního cyklu stránky nebo před Page_PreRender tím.

Platí pro

Viz také