Condividi tramite


Page.RegisterRequiresPostBack(Control) Metodo

Definizione

Registra un controllo in modo che richieda la gestione del postback quando viene eseguito il postback della pagina nel 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)

Parametri

control
Control

Controllo da registrare.

Eccezioni

Il controllo da registrare non implementa l'interfaccia IPostBackDataHandler.

Esempio

Nell'esempio di codice seguente viene utilizzato il RegisterRequiresPostBack metodo per richiedere la pubblicazione di un controllo casella di testo, myTextBox, prima che qualsiasi codice associato alla casella di testo possa essere eseguito. TextBox i controlli implementano l'interfaccia IPostBackDataHandler .

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.

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

Commenti

Il controllo da registrare deve implementare l'interfaccia IPostBackDataHandler o viene generato un oggetto HttpException . Quando implementato da un controllo, l'interfaccia IPostBackDataHandler consente la gestione dei dati postback e la generazione di eventuali eventi di postback dei dati modificati. Per altre informazioni sul modello di evento del controllo server, vedere ASP.NET Modello di evento controllo server Web Form.

Registrare i controlli con la pagina in corrispondenza o prima dell'evento Page_PreRender del ciclo di vita della pagina.

Si applica a

Vedi anche