Partager via

Insertion d'un contrôle utilisateur dans une page Web Forms

  • Article

Les contrôles utilisateur ne fonctionnent que lorsqu'ils sont inclus dans une page Web Forms. Lorsqu'une demande arrive pour une page et que cette page contient un contrôle utilisateur, le contrôle utilisateur passe par toutes les étapes du traitement dont fait l'objet tout contrôle serveur ASP.NET. Pour plus d'informations sur ces étapes de traitement, consultez Traitement d'une page Web Forms.

L'insertion d'un contrôle utilisateur dans une page Web Forms est simple.

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

  1. Dans la page Web Forms conteneur, déclarez une directive @ Register qui comprend :

    • 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 du contrôle utilisateur que vous incluez dans la page Web Forms.

      Remarque   La valeur de l'attribut src peut être soit un chemin d'accès relatif, soit un chemin d'accès absolu au fichier source du contrôle utilisateur à partir du répertoire racine de votre application. Pour une utilisation simplifiée, il est recommandé d'utiliser le chemin d'accès relatif. Le tilde (~) représente le répertoire racine de l'application.

    Par exemple, le code suivant inscrit un contrôle utilisateur défini dans le fichier Login1.ascx. Sa balise de préfixe est Acme et sa balise de nom Login. Ce fichier se trouve dans un répertoire Controls.

    <%@ Register TagPrefix="Acme" TagName="Login" Src="~\controls\login1.ascx" %>

  2. À l'aide de la syntaxe d'un contrôle serveur personnalisé, déclarez l'élément du contrôle utilisateur entre les balises d'ouverture et de fermeture du contrôle serveur HtmlForm (<form runat=server></form>). Par exemple, pour déclarer le contrôle importé à l'étape précédente, utilisez la syntaxe suivante.

    <html>
<body>
<form runat="server">
<Acme:Login id="MyLogin" runat="server"/>
</form>
</body>
</html>

    Remarque   Quel que soit le nombre de contrôles serveur ASP.NET (contrôles utilisateur et autres) que vous incluez dans votre page Web Forms, vous devez inclure un seul contrôle serveur HtmlForm sur une page Web Forms. Insérez tous les contrôles serveur entre les balises d'ouverture et de fermeture de ce contrôle.

Voir aussi

Contrôles utilisateur Web Forms | Création d'un contrôle utilisateur | Gestion des événements serveur dans les pages Web Forms | Gestion d'événements d'un contrôle utilisateur