HOW TO：使用 ASP.NET 語法加入伺服器控制項至 ASP.NET Web 網頁

更新：2007 年 11 月

您可以直接在 .aspx 檔案中宣告 Web 伺服器控制項將其加入至網頁。

注意事項：
如需 ASP.NET Web 網頁控制項的背景資訊，請參閱 ASP.NET Web 伺服器控制項概觀

若要以宣告方式加入控制項

1. 如果您在視覺化設計工具中，請切換至原始檔編輯檢視。

2. 將代表控制項的項目輸入 .aspx 檔案。您實際上使用的語法將視加入的控制項而定，但一般適用以下各點：

   • 控制項必須包含屬性 。

   • 除非控制項是複雜控制項的一部分且將重複 (如同在 GridView、FormView、DetailsView、Repeater 或 DataList 控制項中)，否則請設定控制項的 ID 屬性。

   • 請使用參考 asp 命名空間的 XML 標記宣告 Web 伺服器控制項。

   • 控制項宣告必須正確地關閉。您可以指定明確結尾標記，或如果控制項沒有子項目，則可指定自我結尾標記 (Self-Closing Tag)。唯一的例外是不能包含子項目的 HTML 輸入控制項，如輸入控制項 (例如，HtmlInputText 伺服器控制項宣告式語法、HtmlImage 伺服器控制項宣告式語法和 HtmlButton 伺服器控制項宣告式語法)。

   • 控制項屬性 (Property) 宣告為屬性 (Attribute)。

     以下範例顯示 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>
     

     如需特定 Web 伺服器控制項的宣告語法資訊，請參閱 Web 伺服器控制項語法。

     注意事項：
     如果網頁設計工具無法正確呈現 Web 伺服器控制項，就會顯示有「建立控制項時發生錯誤」文字的灰色方塊。這通常表示控制項的 ASP.NET 語法不正確，例如，如果 Web 伺服器控制項項目中遺漏 屬性，您就會看到這個錯誤訊息。

請參閱

工作

HOW TO：以程式設計方式設定 ASP.NET 伺服器控制項樣式屬性

HOW TO：使用 ASP.NET 語法設定 ASP.NET 伺服器控制項樣式屬性

HOW TO：以程式設計方式設定 HTML 伺服器控制項屬性

概念

ASP.NET Web 伺服器控制項概觀