Share via

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

  • 發行項

更新：2007 年 11 月

讓您能夠處理使用者按一下影像的動作，它可以讓您擁有類似影像對應的功能。

 <asp:ImageButton     AccessKey="string"     AlternateText="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"     DescriptionUrl="uri"     Enabled="True|False"     EnableTheming="True|False"     EnableViewState="True|False"     ForeColor="color name|#dddddd"     Height="size"     ID="string"     ImageAlign="NotSet|Left|Right|Baseline|Top|Middle|Bottom|         AbsBottom|AbsMiddle|TextTop"     ImageUrl="uri"     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"     ToolTip="string"     ValidationGroup="string"     Visible="True|False"     Width="size" />

備註

使用 ImageButton 控制項來顯示會回應滑鼠按鍵動作的影像。請設定 ImageUrl 屬性，指定要在控制項中顯示的影像。

Click 和 Command 事件都會在 ImageButton 控制項按下時引發。

您可以使用 OnClick 事件處理常式，以程式設計的方式判斷按一下影像時的座標位置。然後依據座標值來撰寫回應的程式碼。請注意，原點 (0, 0) 是位於影像的左上角。

您可以使用 OnCommand 事件處理常式，讓 ImageButton 控制項的行為像是個命令按鈕。使用 CommandName 屬性可以將命令名稱與控制項相關聯。這樣可以讓多個 ImageButton 控制項放置於同一個 Web 網頁上。然後，就可以使用程式設計的方式在 OnCommand 事件處理常式中識別 CommandName 屬性的值，決定按一下每一個 ImageButton 控制項時要執行的適當動作。CommandArgument 屬性也可以用來傳遞命令相關的額外資訊，例如指定遞增順序。

注意事項：

由於 <asp:ImageButton> 項目沒有內容，所以您可以使用 /> 結束標記，而不是使用個別的結尾標記。

根據預設，按一下 ImageButton 控制項時便會執行網頁驗證。網頁驗證會判斷網頁上與驗證控制項關聯的輸入控制項，是否通過驗證控制項所指定的驗證規則。如果 ImageButton 控制項必須停用這個行為 (例如 [reset] 按鈕)，請將 CausesValidation 屬性設為 false。

如需 ImageButton Web 伺服器控制項之屬性和事件的詳細資訊，請參閱 ImageButton 類別文件。

範例

下列範例將示範如何使用 ImageButton 控制項，顯示滑鼠指標在影像上按一下時該指標的座標。

注意事項：

下列程式碼範例使用單一檔案程式碼模型，若直接複製到程式碼後置檔案，可能無法正確運作。這個程式碼範例必須複製到 .aspx 副檔名的空文字檔中。如需 Web Form 的詳細資訊，請參閱 ASP.NET Web 網頁程式碼模型。

 
<%@ 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>ImageButton Sample</title>
<script language="VB" runat="server">

      Sub ImageButton_Click(sender As Object, e As ImageClickEventArgs) 
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" & _ 
                       e.X.ToString() & ", " & e.Y.ToString() & ")"
      End Sub

   </script>

</head>

<body>

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

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><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>ImageButton Sample</title>
<script language="C#" runat="server">

      void ImageButton_Click(object sender, ImageClickEventArgs e) 
      {
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" + 
                       e.X.ToString() + ", " + e.Y.ToString() + ")";
      }

   </script>

</head>

<body>

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

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><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>ImageButton Sample</title>
<script language="JSCRIPT" runat="server">

      function ImageButton_Click(sender : Object, e : ImageClickEventArgs) {
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" + e.X.ToString() + ", " + e.Y.ToString() + ")"
      }

   </script>

</head>

<body>

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

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />

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

   </form>

</body>
</html>

請參閱

參考

ImageButton

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

其他資源

Web 伺服器控制項語法