Page.RegisterRequiresPostBack(Control) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

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

HttpException

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 eventi del controllo server, vedere Web Forms ASP.NET Modello di eventi di controllo server.

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