Поделиться через

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

  • Статья

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

Создает на странице Web Forms кнопку в стиле гиперссылки.

<asp:LinkButton
    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"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

Заметки

Элемент управления LinkButton используется для создания на странице Web Forms кнопки, имеющей внешний вид гиперссылки. Текст, отображаемый в элементе управления LinkButton, задается посредством установки свойства Text либо с помощью размещения текста между открывающим и закрывающим тегами элемента управления LinkButton. Можно создать либо командную кнопку, либо кнопку подтверждения.

1cd4z1zs.alert_note(ru-ru,VS.90).gifПримечание.

По внешнему виду элемент управления LinkButton аналогичен элемента управления HyperLink, а по функциональным возможностям — элементу управления Button. Элемент управления HyperLink используется, если необходимо осуществить переход на другую веб-страницу при нажатии этого элемента управления.

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

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

1cd4z1zs.alert_note(ru-ru,VS.90).gifПримечание.

В элементе управления LinkButton выполняются сценарии JavaScript для клиентского обозревателя. Для корректной работы данного элемента управления необходимо, чтобы клиентский обозреватель разрешал выполнение сценариев JavaScript. Дополнительные сведения о клиентском сценарии см. в разделеКлиентский сценарий на веб-страницах ASP.NET. По умолчанию при нажатии элемента управления LinkButton выполняется проверка страницы. Проверка страниц определяет, удовлетворяют ли входные элементы управления, связанные с элементом управления проверки на странице, правилам проверки, заданным элементом управления проверки. Если имеется элемент управления LinkButton, для которого необходимо запретить эти функции (например, кнопка reset), для свойства CausesValidation следует установить значение false.
1cd4z1zs.alert_caution(ru-ru,VS.90).gifВнимание!

До отображения в элементе управления LinkButton текст не преобразуется в формат HTML. Это дает возможность внедрять в текст сценарии, заключенные в теги HTML. Если значения элемента управления вводятся пользователем, следует проверить их на допустимость, чтобы избежать угрозы для безопасности.

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

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

Пример

В следующем примере показано, как с помощью элемента управления LinkButton вывести сообщение, уведомляющее о нажатии этого элемента управления.

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>LinkButton Example</title>
<script language="VB" runat="server">

      Sub LinkButton_Click(sender As Object, e As EventArgs) 
         Label1.Text = "You clicked the link button"
      End Sub

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>


<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>LinkButton Example</title>
<script language="C#" runat="server">

      void LinkButton_Click(Object sender, EventArgs e) 
      {
         Label1.Text="You clicked the link button";
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>


<%@ Page Language="JScript" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>LinkButton Example</title>
<script language="JSCRIPT" runat="server">

      function LinkButton_Click(sender : Object, e : EventArgs){
         Label1.Text = "You clicked the link button"
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>

См. также

Ссылки

LinkButton

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

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