Udostępnij za pośrednictwem

Page.RegisterRequiresPostBack(Control) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Rejestruje kontrolkę jako kontrolkę, która wymaga obsługi ogłaszania zwrotnego po wysłaniu strony z powrotem na serwer.

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

Kontrolka do zarejestrowania.

Wyjątki

HttpException

Kontrolka do zarejestrowania nie implementuje interfejsu IPostBackDataHandler .

Przykłady

W poniższym przykładzie kodu użyto RegisterRequiresPostBack metody , aby wymagać, aby kontrolka myTextBoxpola tekstowego została opublikowana z powrotem przed wykonaniem jakiegokolwiek kodu skojarzonego z polem tekstowym. TextBox kontrolki implementują IPostBackDataHandler interfejs.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

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

Uwagi

Kontrolka, która ma być zarejestrowana, musi implementować IPostBackDataHandler interfejs lub jest wywoływany HttpException . Po zaimplementowaniu za pomocą kontrolki IPostBackDataHandler interfejs umożliwia obsługę danych po powrocie i wywoływanie wszelkich zdarzeń po zmianie danych. Aby uzyskać więcej informacji na temat modelu zdarzeń kontroli serwera, zobacz ASP.NET Web Forms Server Control Event Model.

Zarejestruj kontrolki na stronie lub przed Page_PreRender zdarzeniem cyklu życia strony.

Dotyczy

Zobacz też