Декларативный синтаксис серверного веб-элемента управления Button

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

Отображает на странице Web Forms элемент управления типа "кнопка".

<asp:Button
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    UseSubmitBehavior="True|False"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

Заметки

Элемент управления Button предназначен для создания кнопок на странице Web Forms. Можно создавать два типа кнопок: submit или command.

По умолчанию элемент управления Button является кнопкой submit. У кнопки submit не имеется связанного с ней имени команды (заданного свойством CommandName ), поэтому кнопка выполняет пересылку веб-страницы обратно на сервер. Можно создать обработчик для событий Click, чтобы программным образом управлять действиями, выполняемыми при нажатии кнопки submit.

С кнопкой command связано имя команды, например Sort, заданное свойством CommandName. Это дает возможность создать на одной странице Web Forms несколько элементов управления Button и в обработчике событий Button программно определять, кнопка какого элемента управления Command была нажата. Для кнопки command можно также использовать свойство CommandArgument, позволяющее указывать дополнительную информацию о выполняемой команде, например Ascending. Можно создать обработчик событий для Command, чтобы программным образом управлять действиями, выполняемыми при нажатии кнопки command.

Кнопки Command часто используются в шаблонных элементах управления для передачи информации о выполненном действии родительскому элементу управления, например о выборе в элементе управления DataList или о смене режима в элементе управления FormView.

По умолчанию проверка страницы выполняется при щелчке элемента управления Button. Проверка страниц определяет, передают ли элементы управления вводом, связанные с элементом управления на странице, правила проверки, заданные элементом управления проверкой. Если имеется элемент управления Button, для которого необходимо запретить это поведение (например, кнопка reset), для свойства CausesValidation следует установить значение false.

Примечание.
Поскольку элемент <asp:Button> не имеет содержимого, можно закрыть тег с помощью /> вместо использования отдельного закрывающего тега.

Для указания названия, отображаемого в элементе управления Button, устанавливается свойство Text.

Подробные сведения о свойствах и событиях элемента управления Button см. в документации Button.

Пример

Следующий пример демонстрирует объявление кнопки submit в ASPX-файле.

<asp:Button id="SubmitButton"
     Text="Submit"
     CommandName="Submit"
     OnCommand="CommandBtn_Click"
     runat="server"  />

<asp:Button id="SubmitButton"
     Text="Submit"
     CommandName="Submit"
     OnCommand="CommandBtn_Click"
     runat="server"/>

Следующий пример демонстрирует объявление кнопки command в ASPX-файле.

<asp:Button id="SortAscendingButton"
     Text="Sort Ascending"
     CommandName="Sort"
     CommandArgument="Ascending"
     OnCommand="CommandBtn_Click"
     runat="server"/>

<asp:Button id="SortAscendingButton"
     Text="Sort Ascending"
     CommandName="Sort"
     CommandArgument="Ascending"
     OnCommand="CommandBtn_Click"
     runat="server"/>

В следующем примере показан метод обработки события, получающий нажатие кнопки и отображающий сведения, переданные из кнопки в свойства CommandName и CommandArgument.

Sub CommandBtn_Click(ByVal sender As Object, ByVal e As CommandEventArgs)
    Message.Text = "You clicked the " & e.CommandName & _
                   " - " & e.CommandArgument & " button."
End Sub

void CommandBtn_Click(Object sender, CommandEventArgs e)
{
    Message.Text = "You clicked the " + e.CommandName +
                   " - " + e.CommandArgument + " button.";
}

См. также

Ссылки

Button

Другие ресурсы

Синтаксис серверного веб-элемента управления