Public Class Image Inherits WebControl
Dim instance As Image
public class Image : WebControl
public ref class Image : public WebControl
public class Image extends WebControl
使用 Image 控件在网页上显示图像。通过设置 ImageUrl 属性来指定所显示图像的路径。如果图像不可用,可以通过设置 AlternateText 属性来指定为取代图像而显示的文本。通过设置 ImageAlign 属性来指定图像相对于网页上其他元素的对齐方式。
此控件只显示图像。如果需要捕获图像上的鼠标单击,请使用 ImageButton 控件。
默认情况下,为此控件呈现的标记可能不符合辅助功能标准,例如 Web 内容辅助功能准则 1.0 (WCAG) 优先级 1 准则。有关此控件的辅助功能支持的详细信息,请参见 ASP.NET 控件和辅助功能。
下面的示例说明如何在网页上创建 Image 控件。
下面的代码示例使用单文件代码模型,当它直接复制到代码隐藏文件时可能不能正常工作。此代码示例必须被复制到具有 .aspx 扩展名的空文本文件中。有关 Web 窗体代码模型的更多信息,请参见 ASP.NET 网页代码模型。
<%@ Page Language="VB" %> <html> <head> <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 runat="server"> <h3>Image Example</h3> <font size="5"> 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 </font> <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#" %> <html> <head> <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 runat="server"> <h3>Image Example</h3> <font size="5"> 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 </font> <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" %> <html> <head> <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 runat="server"> <h3>Image Example</h3> <font size="5"> 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 </font> <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>
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 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求。