Sintassi dichiarativa per il controllo server Web ImageButton
Aggiornamento: novembre 2007
Consente di gestire gli eventi Click dell'utente in un'immagine, offrendo una funzionalità simile a una mappa immagine.
<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"
/>
Note
Utilizzare il controllo ImageButton per visualizzare un'immagine che risponde ai clic del mouse. Impostando la proprietà ImageUrl, è possibile specificare l'immagine da visualizzare nel controllo.
Facendo clic sul controllo ImageButton, vengono generati entrambi gli eventi, Click e Command.
Se si utilizza il gestore eventi OnClick, è possibile determinare a livello di codice le coordinate del punto in cui si fa clic sull'immagine. È quindi possibile codificare una risposta in base ai valori delle coordinate. Si noti che l'origine (0, 0) è posizionata nell'angolo superiore sinistro dell'immagine.
È possibile utilizzare il gestore eventi OnCommand per fare in modo che il controllo ImageButton funzioni come un pulsante di comando. Se si utilizza la proprietà CommandName, è possibile associare un nome di comando al controllo. In tal modo si possono inserire più controlli ImageButton nella stessa pagina Web. Il valore della proprietà CommandName può quindi essere identificato a livello di codice nel gestore eventi OnCommand, per determinare l'azione appropriata da eseguire quando si fa clic su ogni controllo ImageButton. Inoltre, è possibile utilizzare la proprietà CommandArgument per passare ulteriori informazioni sul comando, ad esempio per specificare l'ordinamento crescente.
Nota
Poiché l'elemento <asp:ImageButton> non ha contenuto, è possibile chiudere il tag con /> invece di utilizzare un tag di chiusura distinto.
Per impostazione predefinita, la convalida della pagina viene eseguita quando si fa clic su un controllo ImageButton. La convalida della pagina consente di determinare se i controlli di input associati a un controllo di convalida nella pagina passano le regole di convalida specificate dal controllo di convalida stesso. Se è presente un controllo ImageButton che disattiva questa funzionalità, ad esempio un pulsante reset, impostare la proprietà CausesValidation su false.
Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web ImageButton, vedere la documentazione relativa alla classe ImageButton.
Esempio
Nell'esempio riportato di seguito viene illustrato come utilizzare un controllo ImageButton per visualizzare le coordinate del puntatore del mouse quando si fa clic sull'immagine.
Nota
Nell'esempio di codice riportato di seguito viene utilizzato il modello di codice a file singolo e se viene copiato direttamente in un file code-behind, il codice potrebbe non funzionare. È necessario copiare l'esempio di codice in un file di testo vuoto con estensione aspx. Per ulteriori informazioni sul modello di codice di Web Form, vedere Modello di codice di pagine Web ASP.NET.
<%@ 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>
Vedere anche
Riferimenti
Sintassi dichiarativa per il controllo server Web Button