ImageButton-Webserversteuerelement
Ermöglicht die Behandlung von Klickereignissen in einem Bild und stellt damit Funktionen ähnlich der einer Imagemap bereit.
<asp:ImageButtonid="ImageButton1" ImageUrl="string" Command="Command" CommandArgument="CommandArgument" CausesValidation="true | false" OnClick="OnClickMethod" runat="server"/>
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 setzen.
Sowohl das Click-Ereignis als auch das Command-Ereignis wird ausgelöst, wenn auf das ImageButton-Steuerelement geklickt wird.
Mit Hilfe 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 mit Hilfe des OnCommand-Ereignishandlers festlegen, dass das ImageButton-Steuerelement sich 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 mit Hilfe der CommandArgument-Eigenschaft zusätzliche Informationen über den Befehl übergeben werden, z. B. die Festlegung einer aufsteigenden Sortierreihenfolge.
Hinweis Da das <asp:ImageButton>-Element keinen Inhalt hat, können Sie das Tag mit /> abschließen, anstatt ein separates schließendes Tag zu verwenden.
Standardmäßig wird eine Seitenüberprüfung durchgeführt, wenn auf ein ImageButton-Steuerelement geklickt wird. Bei der Seitenüberprüfung wird festgestellt, ob die einem Steuerelement für die Gültigkeitsprüfung auf der Seite zugeordneten Eingabesteuerelemente allen Überprüfungsregeln entsprechen, die durch das Steuerelement für die Gültigkeitsprüfung festgelegt sind. Wenn Sie ein ImageButton-Steuerelement verwenden, für das dieses Verhalten deaktiviert werden muss, z. B. eine Schaltfläche Zurücksetzen, setzen Sie die CausesValidation-Eigenschaft auf false.
Weitere Informationen zu den Eigenschaften und Ereignissen des ImageButton-Webserversteuerelements finden Sie unter ImageButton-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht, wie mit Hilfe eines ImageButton-Steuerelements die Koordinaten des Mauszeigers angezeigt werden, wenn mit dem Zeiger auf das Bild geklickt wird.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script 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>
[C#]
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void ImageButton_Click(object Source, 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"
AlternateText="ImageButton 1"
ImageAlign="left"
ImageUrl="images\pict.jpg"
OnClick="ImageButton_Click"
runat="server"/>
<br><br>
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>