Page.RegisterRequiresPostBack(Control) Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Inscrit un contrôle comme exigeant la gestion de publication (postback) lorsque la page est publiée sur le serveur.

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)

Paramètres

control
Control

Contrôle à inscrire.

Exceptions

HttpException

Le contrôle à inscrire n'implémente pas l'interface IPostBackDataHandler.

Exemples

L’exemple de code suivant utilise la RegisterRequiresPostBack méthode pour exiger un contrôle de zone de texte, myTextBoxpour être publié avant que tout code associé à la zone de texte puisse s’exécuter. TextBox contrôles implémentent l’interface IPostBackDataHandler .

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de 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

Remarques

Le contrôle à inscrire doit implémenter l’interface IPostBackDataHandler ou un HttpException déclenché. Lorsqu’elle est implémentée par un contrôle, l’interface IPostBackDataHandler permet de gérer les données post-back et de déclencher les événements de publication de données modifiés. Pour plus d’informations sur le modèle d’événement de contrôle de serveur, consultez ASP.NET Web Forms modèle d’événement de contrôle de serveur.

Inscrivez des contrôles auprès de la page à l’heure ou avant l’événement Page_PreRender du cycle de vie de la page.

S’applique à

Voir aussi