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 la publication d’un contrôle de zone de texte, myTextBox, avant qu’un code associé à la zone de texte puisse s’exécuter. TextBox les 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 est 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 tous les événements modifiés de données post-back. Pour plus d’informations sur le modèle d’événement de contrôle serveur, consultez ASP.NET Modèle d’événement de contrôle de serveur Web Forms.

Inscrire 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