UserControl, classe

La classe UserControl est associée aux fichiers ayant une extension .ascx. Ces fichiers sont compilés au moment de l'exécution en tant qu'objets UserControl et mis en cache dans la mémoire du serveur.

Vous pouvez imbriquer des contrôles utilisateur en déclarant un fichier .ascx dans un autre et inclure ce dernier dans une page Web Forms.

Les contrôles utilisateur sont contenus dans des pages Web Forms ASP.NET et facilitent pour les développeurs Web la capture d'interfaces utilisateur Web couramment utilisées. Ils sont instanciés et mis en cache selon des méthodes similaires aux objets Page. À la différence des pages, cependant, les contrôles utilisateur ne peuvent pas être appelés indépendamment. Ils ne peuvent être appelés qu'à partir de la page ou d'un autre contrôle utilisateur les contenant.

Dérivez de cette classe si vous souhaitez créer un contrôle utilisateur en utilisant la technique code-behind. Il s'agit de l'option recommandée si vous utilisez cette technique pour développer des pages Web Forms.

Pour plus d'informations sur la création des contrôles utilisateur par déclaration, consultez Contrôles utilisateur ASP.NET.

La classe définie dans l'exemple suivant, SimpleControl, hérite de la classe UserControl et peut être utilisée en tant que classe code-behind ASP.NET. Elle utilise les contrôles serveur Web TextBox, Label et Button ; en outre, elle définit une méthode myButton_Click qui assigne la valeur de propriété TextBox.Text, ainsi que deux chaînes, à la propriété Label.Text.

Note de sécurité
Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle 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 ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script.

using System;
using System.Web.UI;
using System.Web.UI.WebControls;

public class SimpleControl:UserControl
{

  public TextBox name;
  public Label output;
  public Button myButton;

  public void myButton_Click(object sender, EventArgs e)
  { 
    output.Text = "Hello, " + name.Text + ".";

  }

}

L'exemple suivant représente le balisage contenu dans un fichier .ascx. Vous pouvez utiliser la classe SimpleControl définie dans l'exemple précédent en tant que classe code-behind pour le balisage du fichier .ascx.

<%@ control inherits = "SimpleControl" src = "SimpleControl.cs" %>

<table style="background-color:yellow;font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button id="myButton" text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>

.NET Framework

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources