Share via

LinkButton Web 伺服器控制項宣告式語法

  • 發行項

更新：2007 年 11 月

在 Web Form 網頁上建立超連結樣式按鈕。

 <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 Form 網頁上建立超連結樣式按鈕。只要設定 Text 屬性或將文字置於 LinkButton 控制項的開頭和結尾標記之間，即可指定要顯示在 LinkButton 控制項中的文字。您可以建立送出按鈕，或者命令按鈕。

注意事項：

LinkButton 控制項具有與 HyperLink 控制項相同的外觀，不過卻具有與 Button 控制項相同的功能。如果您想要在按一下控制項時連結至另一個 Web 網頁，請使用 HyperLink 控制項。

submit 按鈕沒有與按鈕關聯的命令名稱，只是將 Web 網頁回傳到伺服器。根據預設，LinkButton 控制項會是 submit 按鈕。您可以提供 Click 事件的事件處理常式，以程式的方式控制在按一下 submit 按鈕時執行的動作。

您可以設定 CommandName 屬性，將命令名稱與命令按鈕 (例如 Sort) 關聯。這樣可以讓您在 Web 網頁上建立多個 LinkButton 控制項，並且以程式設計的方式來判斷哪一個 LinkButton 控制項被按一下。您也可以將 CommandArgument 屬性與命令按鈕搭配使用，以提供所要執行命令 (例如 Ascending) 的其他資訊。您可以提供 Command 事件的事件處理常式，以程式設計的方式控制在按一下命令按鈕時所執行的動作。

注意事項：

LinkButton 控制項會在用戶端瀏覽器中轉譯 JavaScript。用戶端瀏覽器必須啟用 JavaScript，這個控制項才能正確運作。如需用戶端指令碼的詳細資訊，請參閱 ASP.NET Web 網頁中的用戶端指令碼。根據預設，當按一下 LinkButton 控制項時，便會執行網頁驗證。網頁驗證會判斷網頁上與驗證控制項關聯的輸入控制項，是否通過驗證控制項所指定的驗證規則。如果 LinkButton 控制項必須停用這個行為 (例如 reset 按鈕)，請將 CausesValidation 屬性設為 false。
警告：

尚未顯示於 LinkButton 控制項中的文字，便還未經過 HTML 編碼。這樣便可以在文字中的 HTML 標記內嵌入指令碼。如果控制項的值來自使用者輸入，請務必驗證值來協助防止安全性的弱點。

Command 按鈕 (例如 LinkButton 控制項) 會在樣板化控制項中經常遭到使用，以便將動作傳送至父控制項。例如，DataList 中的選取範圍，或是在 FormView 中變更模式。

如需 LinkButton Web 伺服器控制項之屬性和事件的詳細資訊，請參閱 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

其他資源

Web 伺服器控制項語法