Procedura: aggiungere controlli server a una pagina Web ASP.NET utilizzando la sintassi ASP.NET

Aggiornamento: novembre 2007

È possibile aggiungere un controllo server Web a una pagina dichiarandolo direttamente nel file aspx.

Nota:
Per informazioni di base sui controlli per le pagine Web ASP.NET, vedere Cenni preliminari sui controlli server Web ASP.NET

Per aggiungere un controllo in modo dichiarativo

1. Se è attiva una finestra di progettazione visiva, passare alla vista di modifica dell'origine.

2. Digitare l'elemento che rappresenta il controllo nel file ASPX. La sintassi esatta utilizzata dipende dal controllo che si aggiunge, ma in generale sono valide le condizioni seguenti:

   • I controlli devono includere l'attributo .

   • Impostare l'attributo ID del controllo a meno che il controllo non faccia parta di un controllo complesso e verrà ripetuto, come nei controlli GridView, FormView, DetailsView, Repeater o DataList.

   • I controlli server Web vengono dichiarati con un tag XML che fa riferimento allo spazio dei nomi asp.

   • Le dichiarazioni dei controlli devono essere chiuse in maniera adeguata. È possibile specificare un tag di chiusura esplicito o un tag di chiusura automatica, se il controllo non è dotato di elementi figlio. Le uniche eccezioni sono rappresentate dai controlli di input HTML che non possono includere elementi figlio, come i controlli di input quali il Sintassi dichiarativa per il controllo server HtmlInputText, il Sintassi dichiarativa per il controllo server HtmlImage e il Sintassi dichiarativa per il controllo server HtmlButton.

   • Le proprietà dei controlli vengono dichiarate come attributi.

     Negli esempi che seguono sono illustrate dichiarazioni tipiche dei controlli server 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>
     

     Per informazioni sulla sintassi dichiarativa per uno specifico controllo server Web, vedere Sintassi dei controlli server Web.

     Nota:
     Se nella finestra di progettazione delle pagine non è possibile eseguire correttamente il rendering di un controllo server Web, verrà visualizzata una casella grigia contenente il messaggio "Errore durante la creazione del controllo". Tale messaggio indica spesso che la sintassi ASP.NET del controllo è errata, ad esempio se l'attributo risulta mancante in un elemento del controllo server Web.

Vedere anche

Attività

Procedura: impostare le proprietà di stile dei controlli server ASP.NET a livello di codice

Procedura: impostare le proprietà di stile dei controlli server ASP.NET utilizzando la sintassi ASP.NET

Procedura: impostare le proprietà dei controlli server HTML a livello di codice

Concetti

Cenni preliminari sui controlli server Web ASP.NET