Практическое руководство. Добавление серверного элемента управления на веб-страницу ASP.NET с использованием синтаксиса ASP.NET

Обновлен: Ноябрь 2007

Можно добавить серверный веб-элемент управления на страницу путем его объявления непосредственно в ASPX-файле.

Примечание.
Общие сведения об элементах управления веб-страниц ASP.NET см. в разделе Общие сведения о серверных веб-элементах управления ASP.NET

Добавление элемента управления декларативно

1. Если вы находитесь в режиме визуального конструктора, переключитесь в представление редактора исходного кода.

2. Введите элемент, представляющий элемент управления в ASPX-файле. Используемый точный синтаксис зависит от добавляемого элемента управления; некоторые общие рекомендации представлены ниже:

   • Элементы управления должны включать атрибут runat="server".

   • Задайте атрибут ID элемента управления, если элемент управления не является частью сложного элемента управления и будет повторяться (как в элементах управления GridView, FormView, DetailsView, Repeater и DataList).

   • Серверные веб-элементы управления должны быть объявлены с помощью тега XML, который ссылается на пространство имен asp.

   • Объявления элементов управления должны быть правильно закрыты. Можно определить явный закрывающий тег или, если у элемента управления нет дочерних элементов, самозакрывающийся тег. Единственным исключением являются HTML-элементы управления ввода, которые не могут иметь дочерние элементы, такие как элементы управления ввода (например, Декларативный синтаксис серверного веб-элемента управления HtmlInputText, Декларативный синтаксис серверного элемента управления HtmlImage и Декларативный синтаксис серверного веб-элемента управления HtmlButton).

   • Свойства элемента управления объявляются как атрибуты.

     Следующие примеры демонстрируют типичные объявления для серверных веб-элементов управления:

     <!-- 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" runat="server">
        <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" runat="server">
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1" runat="server" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" runat="server"
                  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" runat="server">
        <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" runat="server">
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1" runat="server" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" runat="server"
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Ticker") %>'/>
             )
        </ItemTemplate>
        <SeparatorTemplate>
            ,
        </SeparatorTemplate>
     </asp:Repeater>
     

     Подробные сведения о декларативном синтаксисе конкретных серверных веб-элементов управления см. в разделе Синтаксис серверного веб-элемента управления.

     Примечание.
     Если конструктор страниц не может правильно отобразить серверный веб-элемент управления, то он отображает серое окно с текстом «Ошибка при создании элемента управления». Это часто означает, что синтаксис ASP.NET элемента управления неверный — например, ошибка может возникнуть, если в серверном веб-элементе управления отсутствует атрибут runat="server".

См. также

Задачи

Практическое руководство. Программная установка стилей серверных элементов управления ASP.NET

Практическое руководство. Настройка свойств стиля серверного элемента управления ASP.NET с помощью синтаксиса ASP.NET

Практическое руководство. Определение свойств серверных HTML-элементов управления

Основные понятия

Общие сведения о серверных веб-элементах управления ASP.NET