ImageButton 类

项目
08/17/2007

显示图像并对图像上的鼠标单击作出响应的控件。

**命名空间:**System.Web.UI.WebControls
**程序集:**System.Web（在 system.web.dll 中）

语法

声明
Public Class ImageButton
    Inherits Image
    Implements IPostBackDataHandler, IPostBackEventHandler, IButtonControl
用法
Dim instance As ImageButton

public class ImageButton : Image, IPostBackDataHandler, IPostBackEventHandler, IButtonControl

public ref class ImageButton : public Image, IPostBackDataHandler, IPostBackEventHandler, IButtonControl

public class ImageButton extends Image implements IPostBackDataHandler, IPostBackEventHandler, 
    IButtonControl

public class ImageButton extends Image implements IPostBackDataHandler, IPostBackEventHandler, 
    IButtonControl

备注

使用 ImageButton 控件显示对鼠标单击作出响应的图像。

当单击 ImageButton 控件时，将同时引发 Click 和 Command 事件。

使用 OnClick 事件处理程序，可以以编程方式确定图像被单击的位置的坐标。然后，可以根据坐标值编写响应代码。注意，原点 (0, 0) 位于图像的左上角。

可以使用 OnCommand 事件处理程序使 ImageButton 控件的行为类似于命令按钮。使用 CommandName 属性可将命令名与该控件关联。它允许在同一网页上放置多个 ImageButton 控件。然后，可以编程方式在 OnCommand 事件处理程序中标识 CommandName 属性的值，确定在单击每个 ImageButton 控件时执行的相应操作。CommandArgument 属性也可用于传递有关命令的附加信息，如指定升序。

默认情况下，在单击 ImageButton 控件时执行页验证。页验证确定页上与验证控件关联的输入控件是否均通过该验证控件所指定的验证规则。若要禁止执行页验证，需将 CausesValidation 属性设置为 false。

辅助功能

默认情况下，为此控件呈现的标记可能不符合辅助功能标准，例如 Web 内容辅助功能准则 1.0 (WCAG) 优先级 1 准则。有关此控件的辅助功能支持的详细信息，请参见 ASP.NET 控件和辅助功能。

主题	位置
如何：向 Web 窗体页添加 ImageButton Web 服务器控件 (Visual Studio)	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：到自定义业务对象的数据绑定	在 Visual Studio 中构建 ASP .NET Web 应用程序
如何：向 Web 窗体页添加按钮 Web 服务器控件 (Visual Studio)	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建和使用 ASP.NET 母版页	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建和使用 ASP.NET 母版页	使用 Visual Web Developer 生成应用程序
如何：响应客户端脚本中的 Button Web 服务器控件事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 ASP.NET 网页中添加登录按钮	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：在 ASP.NET Web 服务器控件上设置焦点	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：到自定义业务对象的数据绑定	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应 Button Web 服务器控件事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应数据绑定控件中的按钮事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应 DataList 或 Repeater 项中的按钮事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应客户端脚本中的 Button Web 服务器控件事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 ASP.NET 网页中添加登录按钮	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 ImageButton Web 服务器控件 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：在 ASP.NET Web 服务器控件上设置焦点	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：到自定义业务对象的数据绑定	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加按钮 Web 服务器控件 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应 Button Web 服务器控件事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应数据绑定控件中的按钮事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应 DataList 或 Repeater 项中的按钮事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：确定 ImageButton Web 服务器控件中的坐标	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 ImageButton Web 服务器控件 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加按钮 Web 服务器控件 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：确定 ImageButton Web 服务器控件中的坐标	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应客户端脚本中的 Button Web 服务器控件事件	生成 ASP .NET Web 应用程序
如何：向 ASP.NET 网页中添加登录按钮	生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加按钮 Web 服务器控件	生成 ASP .NET Web 应用程序
如何：在 ASP.NET Web 服务器控件上设置焦点	生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 ImageButton Web 服务器控件	生成 ASP .NET Web 应用程序
如何：响应 Button Web 服务器控件事件	生成 ASP .NET Web 应用程序
如何：响应数据绑定控件中的按钮事件	生成 ASP .NET Web 应用程序
如何：响应 DataList、Repeater 或 GridView 项中的按钮事件	生成 ASP .NET Web 应用程序
如何：确定 ImageButton Web 服务器控件中的坐标	生成 ASP .NET Web 应用程序

示例

下面的代码示例演示如何创建显示图像被单击位置的坐标的 ImageButton 控件。

提示

下面的代码示例使用单文件代码模型，当它直接复制到代码隐藏文件时可能不能正常工作。此代码示例必须被复制到具有 .aspx 扩展名的空文本文件中。有关 Web 窗体代码模型的更多信息，请参见 ASP.NET 网页代码模型。

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>

   <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 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" %>
<html>
<head>

   <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 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" %>
<html>
<head>

   <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 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>

.NET Framework 安全性

AspNetHostingPermission 用于在宿主环境中进行操作。要求值：LinkDemand。权限值：Minimal。
AspNetHostingPermission 用于在宿主环境中进行操作。要求值：InheritanceDemand。权限值：Minimal。

继承层次结构

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.Image
        System.Web.UI.WebControls.ImageButton

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

ImageButton 成员
 System.Web.UI.WebControls 命名空间
 Button 类
 Image 类

其他资源

ImageButton Web 服务器控件声明性语法
 Button Web 服务器控件概述