Sintassi dichiarativa per il controllo server Web Image
Aggiornamento: novembre 2007
Visualizza un'immagine compatibile con il Web nella pagina Web Form.
<asp:Image
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"
CssClass="string"
DescriptionUrl="uri"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ForeColor="color name|#dddddd"
GenerateEmptyAlternateText="True|False"
Height="size"
ID="string"
ImageAlign="NotSet|Left|Right|Baseline|Top|Middle|Bottom|
AbsBottom|AbsMiddle|TextTop"
ImageUrl="uri"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
Visible="True|False"
Width="size"
/>
Note
Utilizzare il controllo Image per visualizzare un'immagine nella pagina Web Form. Se si imposta la proprietà ImageUrl, si specifica il percorso dell'immagine visualizzata. Se si imposta la proprietà AlternateText, è possibile specificare il testo da visualizzare al posto dell'immagine quando questa non è disponibile. La proprietà ImageAlign specifica l'allineamento dell'immagine rispetto agli altri elementi nella pagina Web Form.
Nota
Il controllo consente di visualizzare solo un'immagine. Se si desidera che l'immagine funzioni come un pulsante o se è necessario determinare le coordinate del punto in cui fare clic sull'immagine con il puntatore del mouse, utilizzare il controllo ImageButton.
Nota
Poiché l'elemento <asp:Image> non ha contenuto, è possibile chiudere il tag con /> invece di utilizzare un tag di chiusura distinto.
Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web Image, vedere la documentazione relativa a Image.
Esempio
Nell'esempio riportato di seguito viene illustrato come creare un controllo Image in una pagina Web.
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 di codice sottostante, 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" %>
<!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>Image Example</title>
<script language="VB" runat="server">
Sub Button_Click(sender As Object, e As EventArgs)
Select Case DropList1.SelectedIndex
Case 0:
Image1.ImageAlign = ImageAlign.NotSet
Case 1:
Image1.ImageAlign = ImageAlign.Left
Case 2:
Image1.ImageAlign = ImageAlign.Right
Case 3:
Image1.ImageAlign = ImageAlign.Baseline
Case 4:
Image1.ImageAlign = ImageAlign.Top
Case 5:
Image1.ImageAlign = ImageAlign.Middle
Case 6:
Image1.ImageAlign = ImageAlign.Bottom
Case 7:
Image1.ImageAlign = ImageAlign.AbsBottom
Case 8:
Image1.ImageAlign = ImageAlign.AbsMiddle
Case 9:
Image1.ImageAlign = ImageAlign.TextTop
Case Else:
Image1.ImageAlign = ImageAlign.NotSet
End Select
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Image Example</h3>
<div style="font-size:large">
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
</div>
<asp:Image id="Image1" runat="server"
AlternateText="Image text"
ImageAlign="left"
ImageUrl="images/image1.jpg"/>
<hr />
Select Image Align: <br />
<asp:DropDownList id="DropList1"
runat="server">
<asp:ListItem>NotSet</asp:ListItem>
<asp:ListItem>Left</asp:ListItem>
<asp:ListItem>Right</asp:ListItem>
<asp:ListItem>BaseLine</asp:ListItem>
<asp:ListItem>Top</asp:ListItem>
<asp:ListItem>Middle</asp:ListItem>
<asp:ListItem>Bottom</asp:ListItem>
<asp:ListItem>AbsBottom</asp:ListItem>
<asp:ListItem>AbsMiddle</asp:ListItem>
<asp:ListItem>TextTop</asp:ListItem>
</asp:DropDownList>
<br /><br />
<asp:Button id="Button1"
Text="Apply Image Alignment"
OnClick="Button_Click"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<!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>Image Example</title>
<script language="C#" runat="server">
void Button_Click(Object sender, EventArgs e)
{
switch(DropList1.SelectedIndex)
{
case 0:
Image1.ImageAlign = ImageAlign.NotSet;
break;
case 1:
Image1.ImageAlign = ImageAlign.Left;
break;
case 2:
Image1.ImageAlign = ImageAlign.Right;
break;
case 3:
Image1.ImageAlign = ImageAlign.Baseline;
break;
case 4:
Image1.ImageAlign = ImageAlign.Top;
break;
case 5:
Image1.ImageAlign = ImageAlign.Middle;
break;
case 6:
Image1.ImageAlign = ImageAlign.Bottom;
break;
case 7:
Image1.ImageAlign = ImageAlign.AbsBottom;
break;
case 8:
Image1.ImageAlign = ImageAlign.AbsMiddle;
break;
case 9:
Image1.ImageAlign = ImageAlign.TextTop;
break;
default:
Image1.ImageAlign = ImageAlign.NotSet;
break;
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Image Example</h3>
<div style="font-size:large">
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
</div>
<asp:Image id="Image1" runat="server"
AlternateText="Image text"
ImageAlign="left"
ImageUrl="images/image1.jpg"/>
<hr />
Select Image Align: <br />
<asp:DropDownList id="DropList1"
runat="server">
<asp:ListItem>NotSet</asp:ListItem>
<asp:ListItem>Left</asp:ListItem>
<asp:ListItem>Right</asp:ListItem>
<asp:ListItem>BaseLine</asp:ListItem>
<asp:ListItem>Top</asp:ListItem>
<asp:ListItem>Middle</asp:ListItem>
<asp:ListItem>Bottom</asp:ListItem>
<asp:ListItem>AbsBottom</asp:ListItem>
<asp:ListItem>AbsMiddle</asp:ListItem>
<asp:ListItem>TextTop</asp:ListItem>
</asp:DropDownList>
<br /><br />
<asp:Button id="Button1"
Text="Apply Image Alignment"
OnClick="Button_Click"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JSCRIPT" %>
<!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>Image Example</title>
<script language="JSCRIPT" runat="server">
function Button_Click(sender : Object, e : EventArgs){
switch(DropList1.SelectedIndex){
case 0:
Image1.ImageAlign = ImageAlign.NotSet
break
case 1:
Image1.ImageAlign = ImageAlign.Left
break
case 2:
Image1.ImageAlign = ImageAlign.Right
break
case 3:
Image1.ImageAlign = ImageAlign.Baseline
break
case 4:
Image1.ImageAlign = ImageAlign.Top
break
case 5:
Image1.ImageAlign = ImageAlign.Middle
break
case 6:
Image1.ImageAlign = ImageAlign.Bottom
break
case 7:
Image1.ImageAlign = ImageAlign.AbsBottom
break
case 8:
Image1.ImageAlign = ImageAlign.AbsMiddle
break
case 9:
Image1.ImageAlign = ImageAlign.TextTop
break
default:
Image1.ImageAlign = ImageAlign.NotSet
break
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Image Example</h3>
<div style="font-size:large">
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
</div>
<asp:Image id="Image1" runat="server"
AlternateText="Image text"
ImageAlign="left"
ImageUrl="images/image1.jpg"/>
<hr />
Select Image Align: <br />
<asp:DropDownList id="DropList1"
runat="server">
<asp:ListItem>NotSet</asp:ListItem>
<asp:ListItem>Left</asp:ListItem>
<asp:ListItem>Right</asp:ListItem>
<asp:ListItem>BaseLine</asp:ListItem>
<asp:ListItem>Top</asp:ListItem>
<asp:ListItem>Middle</asp:ListItem>
<asp:ListItem>Bottom</asp:ListItem>
<asp:ListItem>AbsBottom</asp:ListItem>
<asp:ListItem>AbsMiddle</asp:ListItem>
<asp:ListItem>TextTop</asp:ListItem>
</asp:DropDownList>
<br /><br />
<asp:Button id="Button1"
Text="Apply Image Alignment"
OnClick="Button_Click"
runat="server"/>
</form>
</body>
</html>