Partager via

Comment : inclure un contrôle utilisateur dans une page Web ASP.NET

  • Article

Mise à jour : novembre 2007

Pour utiliser un contrôle utilisateur, vous devez l'inclure dans une page Web ASP.NET. Lorsqu'une demande est soumise concernant une page et que cette page contient un contrôle utilisateur, celui-ci passe par toutes les étapes du traitement qu'effectuent tous les contrôles serveur ASP.NET. Pour plus d'informations sur ces étapes de traitement, consultez Vue d'ensemble du cycle de vie des pages ASP.NET.

Pour insérer un contrôle utilisateur dans une page Web Forms

  1. Dans la page Web ASP.NET conteneur, créez une directive @ Register comprenant :

    • Un attribut TagPrefix, qui associe un préfixe au contrôle utilisateur. Ce préfixe sera inclus dans la balise d'ouverture de l'élément du contrôle utilisateur.

    • Un attribut TagName, qui associe un nom au contrôle utilisateur. Ce nom sera inclus dans la balise d'ouverture de l'élément du contrôle utilisateur.

    • Un attribut Src, qui définit le chemin d'accès virtuel au fichier contrôle utilisateur que vous incluez.

      Remarque :

      La valeur de l'attribut Src peut être un chemin d'accès, soit relatif, soit absolu, au fichier source du contrôle utilisateur à partir du répertoire racine de votre application. Pour davantage de souplesse, il est conseillé d'utiliser le chemin d'accès relatif. Le tilde (~) représente le répertoire racine de l'application. Les contrôles utilisateur ne peuvent pas être placés dans le répertoire App_Code.

  2. Dans le corps de la page Web, déclarez l'élément contrôle utilisateur à l'intérieur de l'élément form.

  3. Éventuellement, si le contrôle utilisateur expose des propriétés publiques, définissez-les de façon déclarative.

Exemple

L'exemple suivant montre une page Web ASP.NET contenant un contrôle utilisateur. Le contrôle utilisateur se trouve dans le fichier Spinner.ascx du dossier Controls. Dans la page, le contrôle est enregistré comme utilisant le préfixe uc et le nom de balise Spinner. Les propriétés MinValue et MaxValue du contrôle utilisateur sont définies de façon déclarative.

Remarque :

Pour plus d'informations sur le code du contrôle utilisateur utilisé dans cet exemple, consultez Comment : créer des contrôles utilisateur ASP.NET.

 
<%@ Page Language="VB" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

Voir aussi

Concepts

Vue d'ensemble des contrôles utilisateur ASP.NET

Présentation de la création de contrôles ASP.NET personnalisés