Comment : ajouter des contrôles serveur à une page Web ASP.NET à l'aide de la syntaxe ASP.NET

Mise à jour : novembre 2007

Vous pouvez ajouter un contrôle serveur Web à une page en le déclarant directement dans le fichier .aspx.

Remarque :
Pour obtenir des informations générales à propos des contrôles de pages Web ASP.NET, consultez Vue d'ensemble des contrôles serveur Web ASP.NET

Pour ajouter un contrôle de façon déclarative

1. Si vous avez ouvert un concepteur visuel, basculez en mode de modification de la source.

2. Tapez les éléments représentant le contrôle dans le fichier .aspx. La syntaxe exacte à utiliser dépend du contrôle que vous ajoutez. Toutefois, en général, les considérations suivantes s'appliquent :

   • Les contrôles doivent comprendre l'attribut .

   • Définissez l'attribut ID du contrôle à moins que le contrôle fasse partie d'un contrôle complexe et soit répété (dans les contrôles GridView, FormView, DetailsView, Repeater ou DataList, par exemple).

   • Les contrôles serveur Web sont déclarés avec une balise XML qui référence l'espace de noms asp.

   • Les déclarations de contrôles doivent être fermées correctement. Vous pouvez spécifier une balise de fermeture explicite ou, si le contrôle ne possède aucun élément enfant, une balise de fermeture automatique. Les seules exceptions sont les contrôles d'entrée HTML qui ne peuvent pas avoir d'éléments enfants, tels que Syntaxe déclarative du contrôle serveur HtmlInputText, Syntaxe déclarative du contrôle serveur HtmlImage et Syntaxe déclarative du contrôle serveur HtmlButton.

   • Les propriétés des contrôles sont déclarées comme attributs.

     Les exemples suivants montrent les déclarations classiques des contrôles serveur Web :

     <!-- Textbox Web server control -->
     <asp:textbox id="TextBox1" runat="Server" Text=""></asp:textbox>
     
     <!-- Same, but with self-closing element -->
     <asp:textbox id="Textbox2" runat="Server" Text="" />
     
     <!-- Web DropDownList control, which contains subelements -->
     <asp:DropDownList id="DropDown1" >
        <asp:ListItem Value="0">0</asp:ListItem>
        <asp:ListItem Value="1">1</asp:ListItem>
        <asp:ListItem Value="2">2</asp:ListItem>
        <asp:ListItem Value="3">3</asp:ListItem>
     </asp:DropDownList>
     
     <asp:Repeater id="Repeater2" >
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1"  
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Ticker") %>'/>
             )
        </ItemTemplate>
        <SeparatorTemplate>
            ,
        </SeparatorTemplate>
     </asp:Repeater>
     

     <!-- Textbox Web server control -->
     <asp:textbox id="TextBox1" runat="Server" Text=""></asp:textbox>
     
     <!-- Same, but with self-closing element -->
     <asp:textbox id="Textbox2" runat="Server" Text="" />
     
     <!-- Web DropDownList control, which contains subelements -->
     <asp:DropDownList id="DropDown1" >
        <asp:ListItem Value="0">0</asp:ListItem>
        <asp:ListItem Value="1">1</asp:ListItem>
        <asp:ListItem Value="2">2</asp:ListItem>
        <asp:ListItem Value="3">3</asp:ListItem>
     </asp:DropDownList>
     
     <asp:Repeater id="Repeater2" >
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1"  
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Ticker") %>'/>
             )
        </ItemTemplate>
        <SeparatorTemplate>
            ,
        </SeparatorTemplate>
     </asp:Repeater>
     

     Pour plus d'informations sur la syntaxe déclarative d'un contrôle serveur Web spécifique, consultez Syntaxe des contrôles serveur Web.

     Remarque :
     Si le Concepteur de pages ne peut pas rendre correctement un contrôle serveur Web, il affiche une case grise contenant le texte « Erreur lors de la création du contrôle ». Ceci indique généralement que la syntaxe ASP.NET du contrôle est incorrecte. Cette erreur se produira si, par exemple, l'attribut est manquant dans un élément du contrôle serveur Web.

Voir aussi

Tâches

Comment : définir par programme les propriétés de style d'un contrôle serveur ASP.NET

Comment : définir les propriétés de style d'un contrôle serveur ASP.NET à l'aide de la syntaxe ASP.NET

Comment : définir par programme les propriétés des contrôles serveur HTML

Concepts

Vue d'ensemble des contrôles serveur Web ASP.NET