ASP.NET ImageButton 控件用于显示可点击的图像
属性
属性 | 描述 | .NET |
---|---|---|
CausesValidation | 规定在 ImageButton 控件被点击时,是否验证页面 | 1.0 |
CommandArgument | 有关要执行的命令的附加信息 | 1.0 |
CommandName | 与 Command 事件相关的命令 | 1.0 |
GenerateEmptyAlternateText | 规定该控件是否创建空字符串作为替代文本 | 2.0 |
OnClientClick | 当图像被点击时要执行的函数的名称。 | 2.0 |
PostBackUrl | 当 ImageButton 被点击时,从当前页面进行回传的目标页面的 URL | 2.0 |
runat | 规定该控件是一个服务器控件。必须被设置为 "server" | 1.0 |
TagKey | 1.0 | |
ValidationGroup | 当 ImageButton 回传服务器时,该 ImageButton 控件引起验证所针对的控件组 | 2.0 |
ASP.NET ImageButton CausesValidation 属性
ASP.NET ImageButton CausesValidation 属性规定了当 ImageButton 控件被点击时是否验证页面
当按钮被点击时,默认地,页面验证会被执行
该属性大多数情况下被用于在 cancel 或 reset 按钮被点击时防止进行验证
语法
<asp:ImageButton CausesValidation= "TRUE|FALSE" runat="server" />
范例
下面的范例在 ImageButton 被点击时撤销验证
<form runat="server">
<asp:ImageButton id="button1" runat="server" CausesValidation="FALSE" ImageUrl="img.gif" />
</form>
ASP.NET ImageButton ValidationGroup 属性
ASP.NET ImageButton ValidationGroup 属性用于当ImageButton 控件被点击时将客户端脚本设置为运行
除了预定义脚本之外,在该属性中规定的脚本会通过 ImageButton 的 "OnClick" 事件来运行
语法
<asp:ImageButton OnClientClick="func" runat="server" />
属性 | 描述 |
---|---|
func | 当 ImageButton 被点击时被运行的客户端脚本 |
范例
下面的范例在 ImageButton 控件被点击时运行两个脚本
<script runat="server">
Sub script1(obj As Object, e As ImageClickEventArgs)
lblMsg.Text="Hello!"
End Sub
</script>
<form runat="server">
<asp:ImageButton OnClick="script1" OnClientClick="script2()"
ImageUrl="img.gif" runat="server" />
<br />
<asp:label id="lblMsg" runat="server" />
</form>
<script>
function script2()
{
return confirm('Hello!');
}
</script>
ASP.NET ImageButton PostBackUrl 属性
ASP.NET ImageButton PostBackUrl 属性用于获取或设置当 ImageButton 控件被点击时要回传的目标页面的 URL
语法
<asp:ImageButton PostBackUrl="string" runat="server" />
属性 | 描述 |
---|---|
string | 字符串值。规定要回传的目标页面的 URL 默认是空字符串,这会使页面向自身回传 |
范例
下面的范例设置了 ImageButton 控件的回传 URL
<form runat="server">
Name:<asp:textbox id="TextBox1" runat=Server />
<asp:ImageButton id="Button1" ImageUrl="img.gif" PostBackUrl="demo_postbackurl.htmlx" runat="Server" />
</form>
注意: Image 控件 的属性也能够用在 ImageButton 控件上
Web 控件标准属性
- AccessKey
- Attributes
- BackColor
- BorderColor
- BorderStyle
- BorderWidth
- CssClass
- Enabled
- Font
- EnableTheming
- ForeColor
- Height
- IsEnabled
- SkinID
- Style
- TabIndex
- ToolTip
- Width
如果想要查看完整描述,可以访问我们的 Web 控件标准属性
控件标准属性
- AppRelativeTemplateSourceDirectory
- BindingContainer
- ClientID
- Controls
- EnableTheming
- EnableViewState
- ID
- NamingContainer
- Page
- Parent
- Site
- TemplateControl
- TemplateSourceDirectory
- UniqueID
- Visible
如果想要查看完整描述,可以访问我们的 控件标准属性
范例
ImageButton
<script runat="server">
Sub getCoordinates(sender As Object, e As ImageClickEventArgs)
mess.Text="Coordinates: " & e.x & ", " & e.y
End Sub
</script>
<!DOCTYPE html>
<meta charset="utf-8" />
<form runat="server">
<p>Click on the image:</p>
<asp:ImageButton
runat="server"
ImageUrl="/static/i/smiley.gif"
OnClick="getCoordinates"/>
<p><asp:label id="mess" runat="server"/></p>
</form>
范例中,我们声明了一个 ImageButton 控件和一个 Label 控件在用户点击此图像时,会执行 subroutine 子例程这个子例程会把消息 "Coordinates: " 以及单击的 x 和 y 坐标发送到 Label 控件