Deklarative Syntax des ImageButton-Webserversteuerelements
Aktualisiert: November 2007
Ermöglicht die Behandlung von Klickereignissen in einem Bild und stellt damit Funktionen ähnlich der einer Imagemap bereit.
<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"
/>
Hinweise
Verwenden Sie das ImageButton-Steuerelement, um ein Bild anzuzeigen, das auf Mausklicks reagiert. Geben Sie das Bild an, das in dem Steuerelement angezeigt werden soll, indem Sie die ImageUrl-Eigenschaft festlegen.
Sowohl das Click-Ereignis als auch das Command-Ereignis werden ausgelöst, wenn auf das ImageButton-Steuerelement geklickt wird.
Mithilfe des OnClick-Ereignishandlers können Sie programmgesteuert die Koordinaten ermitteln, bei denen auf das Bild geklickt wurde. Basierend auf den jeweiligen Koodinatenwerten können Sie dann eine Antwort codieren. Beachten Sie, dass der Ursprung (0, 0) sich in der linken oberen Ecke des Bildes befindet.
Sie können mithilfe des OnCommand-Ereignishandlers festlegen, dass sich das ImageButton-Steuerelement wie eine Befehlsschaltfläche verhält. Unter Verwendung der CommandName-Eigenschaft kann ein Befehlsname mit dem Steuerelement verknüpft werden. Dadurch können mehrere ImageButton-Steuerelemente auf der gleichen Webseite platziert werden. Der Wert der CommandName-Eigenschaft kann dann programmgesteuert im OnCommand-Ereignishandler ermittelt werden, um die Aktion zu bestimmen, die beim Klicken auf die verschiedenen ImageButton-Steuerelemente ausgeführt werden soll. Außerdem können mithilfe der CommandArgument-Eigenschaft zusätzliche Informationen über den Befehl übergeben werden, z. B. die Festlegung einer aufsteigenden Sortierreihenfolge.
Tipp
Da das <asp:ImageButton>-Element keinen Inhalt enthält, können Sie das Tag anstatt mit einem separaten Endtag mit /> schließen.
Standardmäßig wird eine Seitenvalidierung durchgeführt, wenn auf ein ImageButton-Steuerelement geklickt wird. Bei der Seitenvalidierung wird festgestellt, ob die einem Validierungssteuerelement auf der Seite zugeordneten Eingabesteuerelemente allen Validierungsregeln entsprechen, die durch das Validierungssteuerelement festgelegt sind. Wenn ein ImageButton-Steuerelement dieses Verhalten deaktivieren muss, z. B. eine Schaltfläche reset, legen Sie die CausesValidation-Eigenschaft auf false fest.
Ausführliche Informationen zu den Eigenschaften und Ereignissen von ImageButton-Webserversteuerelementen finden Sie in der Dokumentation zur ImageButton-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht, wie mithilfe eines ImageButton-Steuerelements die Koordinaten des Mauszeigers angezeigt werden, wenn mit dem Zeiger auf das Bild geklickt wird.
Tipp
Das folgende Codebeispiel verwendet das Einzeldatei-Codemodell und funktioniert möglicherweise nicht korrekt, wenn es direkt in eine Code-Behind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung .aspx kopiert werden. Weitere Informationen über das Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.
<%@ 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>
Siehe auch
Referenz
Deklarative Syntax des Button-Webserversteuerelements