Page.RegisterRequiresPostBack(Control) Metod

Definition

Namnområde:
System.Web.UI
Sammansättning:
System.Web.dll

Registrerar en kontroll som en kontroll som kräver postback-hantering när sidan publiceras tillbaka till servern.

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)

Parametrar

control
Control

Kontrollen som ska registreras.

Undantag

HttpException

Kontrollen som ska registreras implementerar IPostBackDataHandler inte gränssnittet.

Exempel

I följande kodexempel används RegisterRequiresPostBack metoden för att kräva att en textrutekontroll, , myTextBoxpubliceras tillbaka innan någon kod som är associerad med textrutan kan köras. TextBox kontroller implementerar IPostBackDataHandler gränssnittet.

Important

Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.

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

Kommentarer

Kontrollen som ska registreras måste implementera IPostBackDataHandler gränssnittet eller så aktiveras en HttpException . När det implementeras av en kontroll IPostBackDataHandler möjliggör gränssnittet hantering av post-back-data och höjning av eventuella händelser som har ändrats efter serverdelsdata. Mer information om händelsemodellen för serverkontroll finns i ASP.NET Web Forms Händelsemodell för serverkontroll.

Registrera kontroller med sidan vid eller före Page_PreRender händelse av sidlivscykeln.

Gäller för

Se även