ImageButton-Klasse
Ein Steuerelement, das ein Bild anzeigt und auf Mausklicks auf dieses Bild reagiert.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class ImageButton
Inherits Image
Implements IPostBackDataHandler, IPostBackEventHandler, IButtonControl
'Usage
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
Hinweise
Verwenden Sie das ImageButton-Steuerelement, um ein Bild anzuzeigen, das auf Mausklicks reagiert.
Durch Klicken auf das ImageButton-Steuerelement wird sowohl das Click-Ereignis als auch das Command-Ereignis ausgelöst.
Mithilfe des OnClick-Ereignishandlers können Sie programmgesteuert die Koordinaten der Position bestimmen, an der auf das Bild geklickt wird. Basierend auf den jeweiligen Koordinatenwerten können Sie dann eine Antwort codieren. Der Ursprung (0, 0) befindet sich in der linken oberen Ecke des Bilds.
Sie können mithilfe des OnCommand-Ereignishandlers festlegen, dass das ImageButton-Steuerelement wie eine Befehlsschaltfläche funktionieren soll. Unter Verwendung der CommandName-Eigenschaft kann dem Steuerelement ein Befehlsname zugeordnet werden. Auf diese Weise ist es möglich, mehrere ImageButton-Steuerelemente auf derselben Webseite zu platzieren. Der Wert der CommandName-Eigenschaft kann dann programmgesteuert im OnCommand-Ereignishandler bezeichnet werden, um die Aktion zu bestimmen, die beim Klicken auf das jeweilige ImageButton-Steuerelement ausgeführt werden soll. Mit der CommandArgument-Eigenschaft können außerdem zusätzliche Informationen über den Befehl übergeben werden, z. B. aufsteigende Sortierung.
Standardmäßig wird beim Klicken auf ein ImageButton-Steuerelement eine Seitenvalidierung durchgeführt. Die Seitenvalidierung bestimmt, ob die einem Validierungssteuerelement auf der Seite zugeordneten Eingabesteuerelemente allen Validierungsregeln entsprechen, die durch das Validierungssteuerelement festgelegt sind. Wenn keine Seitenvalidierung durchgeführt werden soll, muss die CausesValidation-Eigenschaft auf false festgelegt werden.
Eingabehilfen
Das für dieses Steuerelement standardmäßig wiedergegebene Markup entspricht eventuell nicht den Standards für die Eingabehilfen wie beispielsweise den Richtlinien der Web Content Accessibility Guidelines 1.0 (WCAG) mit der Priorität 1. Details über die Unterstützung von Eingabehilfen für dieses Steuerelement finden Sie unter Steuerelemente und Eingabehilfen von ASP.NET.
Beispiel
Das folgende Codebeispiel veranschaulicht, wie ein ImageButton-Steuerelement erstellt wird, das die Koordinaten der Position anzeigt, auf die auf einem Bild geklickt wird.
Hinweis
Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.
<%@ 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-Sicherheit
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand. Berechtigungswert: Minimal.
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand. Berechtigungswert: Minimal.
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Image
System.Web.UI.WebControls.ImageButton
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
ImageButton-Member
System.Web.UI.WebControls-Namespace
Button-Klasse
Image-Klasse
Weitere Ressourcen
Deklarative Syntax des ImageButton-Webserversteuerelements
Übersicht über die Button-Webserversteuerelemente