Page.RegisterRequiresPostBack(Control) Méthode

Définition

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

Inscrit un contrôle en tant que contrôle qui nécessite une gestion de publication 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é à nouveau avant que tout code associé à la zone de texte puisse s’exécuter. TextBox les contrôles implémentent l’interface IPostBackDataHandler .

Important

Cet exemple contient une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits 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 élément 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 des é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 Server Control Event Model.

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