Image 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在網頁上顯示圖片。
public ref class Image : System::Web::UI::WebControls::WebControlpublic class Image : System.Web.UI.WebControls.WebControltype Image = class
inherit WebControlPublic Class Image
Inherits WebControl- 繼承
- 衍生
範例
以下範例示範如何在網頁上建立 Image 控制項。
備註
以下程式碼範例採用單檔案程式碼模型，若直接複製到程式碼背後的檔案中，可能無法正常運作。 此程式碼範例必須複製到一個具有 .aspx 副檔名的空文字檔中。 欲了解更多關於網頁表單程式碼模型的資訊，請參見 ASP.NET 網頁表單頁面程式碼模型。
<%@ 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="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>
備註
本主題內容：
簡介
這個 Image 控制項讓你可以處理伺服器程式碼中的影像。 使用控制 Image 項在網頁上顯示請求瀏覽器所支援的任何有效圖片。 顯示影像的路徑是透過設定 ImageUrl 屬性來指定。 你可以透過設定 AlternateText 屬性來指定在圖片無法使用時，將文字取代圖片。 圖片相對於網頁其他元素的對齊方式，則由設定 ImageAlign 屬性來指定。
備註
此控制器僅顯示影像。 如果你需要捕捉滑鼠點擊畫面，請使用 ImageButton 控制鍵。
無障礙設施
關於如何配置此控制項以產生符合無障礙標準的標記，請參閱 Visual Studio 中的無障礙，ASP.NETASP.NET 控制項與無障礙。
宣告式語法
<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"
/>
建構函式
| 名稱 | Description |
|---|---|
| Image() |
初始化 Image 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| AccessKey |
取得或設定存取金鑰，讓你能快速導航到網頁伺服器控制。 (繼承來源 WebControl) |
| Adapter |
拿到瀏覽器專用的控制器轉接器。 (繼承來源 Control) |
| AlternateText |
當圖片無法取得時，會取得或設定控制項中 Image 顯示的替代文字。 支援工具提示功能的瀏覽器會將此文字顯示為工具提示。 |
| AppRelativeTemplateSourceDirectory |
取得或設定包含此控制項的 or UserControl 物件的Page應用程式相對虛擬目錄。 (繼承來源 Control) |
| Attributes |
取得一組任意屬性（僅用於渲染），這些屬性與控制項上的屬性不對應。 (繼承來源 WebControl) |
| BackColor |
取得或設定網頁伺服器控制項的背景色。 (繼承來源 WebControl) |
| BindingContainer |
取得包含該控制項資料綁定的控制項。 (繼承來源 Control) |
| BorderColor |
取得或設定網頁控制的邊框顏色。 (繼承來源 WebControl) |
| BorderStyle |
取得或設定網頁伺服器控制的邊界樣式。 (繼承來源 WebControl) |
| BorderWidth |
取得或設定網頁伺服器控制的邊界寬度。 (繼承來源 WebControl) |
| ChildControlsCreated |
會取得一個值，表示伺服器控制項的子控制項是否已被建立。 (繼承來源 Control) |
| ClientID |
取得由 ASP.NET 產生的 HTML 標記的控制 ID。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用於產生屬性值 ClientID 的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
會得到一個字元值，代表該屬性中使用 ClientID 的分隔符字元。 (繼承來源 Control) |
| Context |
取得 HttpContext 與伺服器控制項相關聯的物件，用於目前的網頁請求。 (繼承來源 Control) |
| Controls |
取得 ControlCollection 一個物件，代表 UI 階層中指定伺服器控制項的子控制項。 (繼承來源 Control) |
| ControlStyle |
這就有網頁伺服器控制的風格。 此特性主要由對照顯影劑使用。 (繼承來源 WebControl) |
| ControlStyleCreated |
會取得一個值，表示該屬性是否 Style 已建立 ControlStyle 物件。 此特性主要由控制顯影劑使用。 (繼承來源 WebControl) |
| CssClass |
取得或設定由網頁伺服器控制項在用戶端渲染的層疊樣式表（CSS）類別。 (繼承來源 WebControl) |
| DataItemContainer |
如果命名容器實 IDataItemContainer作 。 (繼承來源 Control) |
| DataKeysContainer |
如果命名容器實 IDataKeysControl作 。 (繼承來源 Control) |
| DescriptionUrl |
取得或設定位置，並附上圖片的詳細描述。 |
| DesignMode |
會獲得一個值，表示是否在設計表面上使用控制項。 (繼承來源 Control) |
| Enabled |
取得或設定一個值，表示該控制是否啟用。 |
| EnableTheming |
取得或設定一個值，指示主題是否適用於此控制。 (繼承來源 WebControl) |
| EnableViewState |
取得或設定一個值，指示伺服器控制項是否能持久化其視圖狀態，以及其包含的任何子控制項的視圖狀態，給請求端客戶端。 (繼承來源 Control) |
| Events |
會取得一個事件處理代理清單來管理控制。 這個屬性是唯讀的。 (繼承來源 Control) |
| Font |
取得與控制項相關文字的字型屬性。 |
| ForeColor |
取得或設定網頁伺服器控制項的前景顏色（通常是文字顏色）。 (繼承來源 WebControl) |
| GenerateEmptyAlternateText |
取得或設定一個值，指示控制項是否為空字串值產生替代文字屬性。 |
| HasAttributes |
會得到一個值，表示控制項是否設定了屬性。 (繼承來源 WebControl) |
| HasChildViewState |
會取得一個值，表示目前伺服器控制項的子控制項是否儲存了任何檢視狀態設定。 (繼承來源 Control) |
| Height |
取得或設定網頁伺服器控制的高度。 (繼承來源 WebControl) |
| ID |
取得或設定分配給伺服器控制的程式識別碼。 (繼承來源 Control) |
| IdSeparator |
取得用來分離控制識別碼的字元。 (繼承來源 Control) |
| ImageAlign |
取得或設定控制項與網頁上其他元素的對齊 Image 。 |
| ImageUrl |
取得或設定提供圖片路徑的網址，以便在控制項中 Image 顯示。 |
| IsChildControlStateCleared |
會取得一個值，表示該控制中所包含的控制是否具有控制狀態。 (繼承來源 Control) |
| IsEnabled |
會得到一個值，表示該控制項是否已啟用。 (繼承來源 WebControl) |
| IsTrackingViewState |
會得到一個值，表示伺服器控制是否正在儲存對其檢視狀態的變更。 (繼承來源 Control) |
| IsViewStateEnabled |
會取得一個值，表示此控制是否啟用了檢視狀態。 (繼承來源 Control) |
| LoadViewStateByID |
會得到一個值，表示控制項是否參與載入其視圖狀態 ID ，而非索引。 (繼承來源 Control) |
| NamingContainer |
會取得伺服器控制項命名容器的參考，該容器會建立一個獨特的命名空間，用來區分具有相同 ID 屬性值的伺服器控制項。 (繼承來源 Control) |
| Page |
會取得包含 Page 伺服器控制的實例參考。 (繼承來源 Control) |
| Parent |
在頁面控制階層中，會取得伺服器控制項的父控制權的參考。 (繼承來源 Control) |
| RenderingCompatibility |
會得到一個值，指定渲染後的 HTML 會相容的 ASP.NET 版本。 (繼承來源 Control) |
| Site |
當在設計表面渲染時，會取得承載當前控制項的容器資訊。 (繼承來源 Control) |
| SkinID |
取得或設定皮膚貼合控制劑。 (繼承來源 WebControl) |
| Style |
會取得一組文字屬性，這些屬性會被渲染成 Web 伺服器控制項外層標籤上的樣式屬性。 (繼承來源 WebControl) |
| SupportsDisabledAttribute |
會取得一個值，指示當控制項IsEnabled屬性為 |
| TabIndex |
取得或設定網頁伺服器控制的分頁索引。 (繼承來源 WebControl) |
| TagKey |
取得 HtmlTextWriterTag 對應於此網頁伺服器控制的值。 此特性主要由對照顯影劑使用。 (繼承來源 WebControl) |
| TagName |
取得控制標籤名稱。 此特性主要由對照顯影劑使用。 (繼承來源 WebControl) |
| TemplateControl |
取得或設定包含此控制項的範本參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含當前伺服器控制權的 or UserControl 虛擬目錄Page。 (繼承來源 Control) |
| ToolTip |
當滑鼠指標懸停在網頁伺服器控制項上時，會取得或設定顯示的文字。 (繼承來源 WebControl) |
| UniqueID |
取得伺服器控制的唯一、階層限定的識別碼。 (繼承來源 Control) |
| ValidateRequestMode |
取得或設定一個值，指示控制器是否檢查瀏覽器的客戶端輸入是否有潛在危險的值。 (繼承來源 Control) |
| ViewState |
取得狀態資訊字典，讓你能儲存並還原伺服器控制的多個請求，針對同一頁面。 (繼承來源 Control) |
| ViewStateIgnoresCase |
會得到一個值，表示該物件是否 StateBag 不區分大小寫。 (繼承來源 Control) |
| ViewStateMode |
取得或設定此控制的視圖狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定一個值，指示伺服器控制項是否以 UI 形式呈現在頁面上。 (繼承來源 Control) |
| Width |
取得或設定網頁伺服器控制的寬度。 (繼承來源 WebControl) |
方法
事件
| 名稱 | Description |
|---|---|
| DataBinding |
當伺服器控制項綁定到資料來源時會發生。 (繼承來源 Control) |
| Disposed |
當伺服器控制從記憶體中釋放時發生，這是伺服器控制生命週期中請求 ASP.NET 頁面的最後階段。 (繼承來源 Control) |
| Init |
發生在伺服器控制初始化時，這是其生命週期的第一步。 (繼承來源 Control) |
| Load |
當伺服器控制項載入 Page 物件時會發生。 (繼承來源 Control) |
| PreRender |
發生在物件載入後 Control 但渲染之前。 (繼承來源 Control) |
| Unload |
當伺服器控制項從記憶體卸載時發生。 (繼承來源 Control) |
明確介面實作
擴充方法
| 名稱 | Description |
|---|---|
| FindDataSourceControl(Control) |
回傳與指定控制項相關聯的資料來源。 |
| FindFieldTemplate(Control, String) |
回傳指定控制項命名容器中指定欄位的欄位範本。 |
| FindMetaTable(Control) |
回傳包含資料控制項的元值物件。 |
