HtmlImage 類別

定義

命名空間:: System.Web.UI.HtmlControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供伺服器上 HTML <img> 元素的程式存取。

public ref class HtmlImage : System::Web::UI::HtmlControls::HtmlControl

public class HtmlImage : System.Web.UI.HtmlControls.HtmlControl

type HtmlImage = class
    inherit HtmlControl

Public Class HtmlImage
Inherits HtmlControl

繼承: Object

Control

HtmlControl
HtmlImage

範例

以下程式碼範例示範如何在點擊 an HtmlImage 時以程式方式修改控制項的屬性HtmlButton。

<%@ 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>HtmlImage Example</title>
<script language="C#" runat="server">
        
       void Image1_Click(object sender, EventArgs e) 
       {
          Image1.Src="Image1.jpg";
          Image1.Height=226;
          Image1.Width=500;
          Image1.Border=5;
          Image1.Align="center";
          Image1.Alt="Image 1";
       }
    
       void Image2_Click(object sender, EventArgs e) 
       {
          Image1.Src="Image2.jpg";
          Image1.Height=480;
          Image1.Width=640;
          Image1.Border=7;
          Image1.Align="left";
          Image1.Alt="Image 2";
       }
 
       void Image3_Click(object sender, EventArgs e) 
       {
          Image1.Src="Image3.jpg";
          Image1.Height=413;
          Image1.Width=631;
          Image1.Border=3;
          Image1.Align="right";
          Image1.Alt="Image 3";
       }
 
    </script>
 
 </head>
 
 <body>
 
    <form id="form1" runat="server">
 
       <h3>HtmlImage Example</h3>
       
       <center>
 
          <button id="Button1"
                  onserverclick="Image1_Click" 
                  runat="server">
          Image 1
          </button>
 
          <button id="Button2"
                  onserverclick="Image2_Click" 
                  runat="server">
          Image 2
          </button>
 
          <button id="Button3"
                  onserverclick="Image3_Click" 
                  runat="server">
          Image 3
          </button>
 
       </center>
       
       <br /><br />
     
       <img id ="Image1"
            src="Image1.jpg"
            alt="Image 1"
            runat="server"
            style="width:500; height:226; border:5; text-align:center" />
       Enter the caption for this image here.
    
    </form>
 
 </body>
 </html>

<%@ 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>HtmlImage Example</title>
<script language="VB" runat="server">
        
    Sub Image1_Click(sender As Object, e As EventArgs)
        Image1.Src = "Image1.jpg"
        Image1.Height = 226
        Image1.Width = 500
        Image1.Border = 5
        Image1.Align = "center"
        Image1.Alt = "Image 1"
    End Sub 'Image1_Click


    Sub Image2_Click(sender As Object, e As EventArgs)
        Image1.Src = "Image2.jpg"
        Image1.Height = 480
        Image1.Width = 640
        Image1.Border = 7
        Image1.Align = "left"
        Image1.Alt = "Image 2"
    End Sub 'Image2_Click


    Sub Image3_Click(sender As Object, e As EventArgs)
        Image1.Src = "Image3.jpg"
        Image1.Height = 413
        Image1.Width = 631
        Image1.Border = 3
        Image1.Align = "right"
        Image1.Alt = "Image 3"
    End Sub 'Image3_Click
 
  </script>
 
 </head>
 
 <body>
 
    <form id="form1" runat="server">
 
       <h3>HtmlImage Example</h3>
       
       <center>
 
          <button id="Button1"
                  onserverclick="Image1_Click" 
                  runat="server">
          Image 1
          </button>
 
          <button id="Button2"
                  onserverclick="Image2_Click" 
                  runat="server">
          Image 2
          </button>
 
          <button id="Button3"
                  onserverclick="Image3_Click" 
                  runat="server">
          Image 3
          </button>
 
       </center>
       
       <br /><br />
     
       <img id ="Image1"
            src="Image1.jpg"
            alt="Image 1"
            runat="server"
            style="width:500; height:226; border:5; text-align:center" />
      Enter the caption for this image here.
    
    </form>
 
 </body>
 </html>

備註

使用此控制項在網頁上顯示圖片。 HtmlImage這個控制項可以透過程式操作，改變顯示的影像、影像大小，以及影像相對於其他頁面元素的對齊方式。

如需實例 HtmlImage的初始屬性值清單，請參閱建構函式 HtmlImage 。

建構函式

名稱	Description
HtmlImage()	初始化 HtmlImage 類別的新執行個體。

屬性

名稱	Description
Adapter	拿到瀏覽器專用的控制器轉接器。 (繼承來源 Control)
Align	取得或設定圖片相對於其他網頁元素的對齊。
Alt	若圖片無法使用或正在下載且尚未完成，瀏覽器會自動取得或設定替代標題。
AppRelativeTemplateSourceDirectory	取得或設定包含此控制項的 or Page 物件的UserControl應用程式相對虛擬目錄。 (繼承來源 Control)
Attributes	取得 ASP.NET 頁面中伺服器控制標籤中所有屬性名稱與值對的集合。 (繼承來源 HtmlControl)
BindingContainer	取得包含該控制項資料綁定的控制項。 (繼承來源 Control)
Border	取得或設定影像的畫面寬度。
ChildControlsCreated	會取得一個值，表示伺服器控制項的子控制項是否已被建立。 (繼承來源 Control)
ClientID	取得由 ASP.NET 產生的 HTML 標記的控制 ID。 (繼承來源 Control)
ClientIDMode	取得或設定用於產生屬性值 ClientID 的演算法。 (繼承來源 Control)
ClientIDSeparator	會得到一個字元值，代表該屬性中使用 ClientID 的分隔符字元。 (繼承來源 Control)
Context	取得 HttpContext 與伺服器控制項相關聯的物件，用於目前的網頁請求。 (繼承來源 Control)
Controls	取得 ControlCollection 一個物件，代表 UI 階層中指定伺服器控制項的子控制項。 (繼承來源 Control)
DataItemContainer	如果命名容器實 IDataItemContainer作。 (繼承來源 Control)
DataKeysContainer	如果命名容器實 IDataKeysControl作。 (繼承來源 Control)
DesignMode	會獲得一個值，表示是否在設計表面上使用控制項。 (繼承來源 Control)
Disabled	取得或設定一個值，指示 HTML 伺服器控制項是否被停用。 (繼承來源 HtmlControl)
EnableTheming	取得或設定一個值，指示主題是否適用於此控制。 (繼承來源 Control)
EnableViewState	取得或設定一個值，指示伺服器控制項是否能持久化其視圖狀態，以及其包含的任何子控制項的視圖狀態，給請求端客戶端。 (繼承來源 Control)
Events	會取得一個事件處理代理清單來管理控制。這個屬性是唯讀的。 (繼承來源 Control)
HasChildViewState	會取得一個值，表示目前伺服器控制項的子控制項是否儲存了任何檢視狀態設定。 (繼承來源 Control)
Height	取得或設定影像的高度。
ID	取得或設定分配給伺服器控制的程式識別碼。 (繼承來源 Control)
IdSeparator	取得用來分離控制識別碼的字元。 (繼承來源 Control)
IsChildControlStateCleared	會取得一個值，表示該控制中所包含的控制是否具有控制狀態。 (繼承來源 Control)
IsTrackingViewState	會得到一個值，表示伺服器控制是否正在儲存對其檢視狀態的變更。 (繼承來源 Control)
IsViewStateEnabled	會取得一個值，表示此控制是否啟用了檢視狀態。 (繼承來源 Control)
LoadViewStateByID	會得到一個值，表示控制項是否參與載入其視圖狀態 ID ，而非索引。 (繼承來源 Control)
NamingContainer	會取得伺服器控制項命名容器的參考，該容器會建立一個獨特的命名空間，用來區分具有相同 ID 屬性值的伺服器控制項。 (繼承來源 Control)
Page	會取得包含 Page 伺服器控制的實例參考。 (繼承來源 Control)
Parent	在頁面控制階層中，會取得伺服器控制項的父控制權的參考。 (繼承來源 Control)
RenderingCompatibility	會得到一個值，指定渲染後的 HTML 會相容的 ASP.NET 版本。 (繼承來源 Control)
Site	當在設計表面渲染時，會取得承載當前控制項的容器資訊。 (繼承來源 Control)
SkinID	取得或設定皮膚貼合控制劑。 (繼承來源 Control)
Src	取得或設定影像檔案的來源來顯示。
Style	會取得一套套用所有層疊樣式表（CSS）屬性的集合，套用到 ASP.NET 檔案中指定的 HTML 伺服器控制項。 (繼承來源 HtmlControl)
TagName	取得包含 `runat=server` 屬性與值對的標籤元素名稱。 (繼承來源 HtmlControl)
TemplateControl	取得或設定包含此控制項的範本參考。 (繼承來源 Control)
TemplateSourceDirectory	取得包含當前伺服器控制權的 or Page 虛擬目錄UserControl。 (繼承來源 Control)
UniqueID	取得伺服器控制的唯一、階層限定的識別碼。 (繼承來源 Control)
ValidateRequestMode	取得或設定一個值，指示控制器是否檢查瀏覽器的客戶端輸入是否有潛在危險的值。 (繼承來源 Control)
ViewState	取得狀態資訊字典，讓你能儲存並還原伺服器控制的多個請求，針對同一頁面。 (繼承來源 Control)
ViewStateIgnoresCase	會得到一個表示視圖狀態是否 HtmlControl 區分大小寫的值。 (繼承來源 HtmlControl)
ViewStateMode	取得或設定此控制的視圖狀態模式。 (繼承來源 Control)
Visible	取得或設定一個值，指示伺服器控制項是否以 UI 形式呈現在頁面上。 (繼承來源 Control)
Width	設定或設定影像的寬度。

方法

名稱	Description
AddedControl(Control, Int32)	在將子控制項加入 Controls 物件集合 Control 後被呼叫。 (繼承來源 Control)
AddParsedSubObject(Object)	通知伺服器控制項有元素（XML 或 HTML）被解析，並將該元素加入伺服器控制項的 ControlCollection 物件中。 (繼承來源 Control)
ApplyStyleSheetSkin(Page)	將頁面樣式表中定義的樣式屬性套用到控制項上。 (繼承來源 Control)
BeginRenderTracing(TextWriter, Object)	開始設計時的渲染資料追蹤。 (繼承來源 Control)
BuildProfileTree(String, Boolean)	收集伺服器控制的資訊，並在啟用追蹤時傳送至 Trace 屬性中顯示。 (繼承來源 Control)
ClearCachedClientID()	將快 ClientID 取值設為 `null`。 (繼承來源 Control)
ClearChildControlState()	刪除伺服器控制項子控制項的控制狀態資訊。 (繼承來源 Control)
ClearChildState()	刪除所有伺服器控制項子控制項的檢視狀態與控制狀態資訊。 (繼承來源 Control)
ClearChildViewState()	刪除伺服器所有子控制項的檢視狀態資訊。 (繼承來源 Control)
ClearEffectiveClientIDMode()	將目前控制實例及任何子控制的屬性設定 ClientIDMode 為 Inherit。 (繼承來源 Control)
CreateChildControls()	由 ASP.NET 頁面框架呼叫，用以通知使用組合基礎實作建立子控制項的伺服器控制項，以便回傳或渲染。 (繼承來源 Control)
CreateControlCollection()	建立一個新 ControlCollection 物件來存放伺服器控制項的子控制項（字面控制項與伺服器控制項）。 (繼承來源 HtmlControl)
DataBind()	將資料來源綁定到呼叫的伺服器控制項及其所有子控制項。 (繼承來源 Control)
DataBind(Boolean)	將資料來源綁定到呼叫的伺服器控制項及其所有子控制項，並有選項 DataBinding 提出事件。 (繼承來源 Control)
DataBindChildren()	將資料來源綁定到伺服器控制項的子控制項。 (繼承來源 Control)
Dispose()	允許伺服器控制在從記憶體中釋放前執行最終清理。 (繼承來源 Control)
EndRenderTracing(TextWriter, Object)	結束了渲染資料的設計時追蹤。 (繼承來源 Control)
EnsureChildControls()	判斷伺服器控制是否包含子控制項。如果沒有，就會產生兒童控制。 (繼承來源 Control)
EnsureID()	為未指派識別碼的控制建立識別碼。 (繼承來源 Control)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FindControl(String, Int32)	搜尋目前的命名容器，使用指定的 `id` 與參數中 `pathOffset` 指定的整數，協助搜尋。你不應該覆蓋這個版本的方法 FindControl 。 (繼承來源 Control)
FindControl(String)	在目前命名容器中搜尋具有指定 `id` 參數的伺服器控制項。 (繼承來源 Control)
Focus()	將輸入焦點設定到控制器。 (繼承來源 Control)
GetAttribute(String)	取得控制項上 HtmlControl 所命名屬性的值。 (繼承來源 HtmlControl)
GetDesignModeState()	取得設計時數據以支援控制。 (繼承來源 Control)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetRouteUrl(Object)	取得對應一組路由參數的網址。 (繼承來源 Control)
GetRouteUrl(RouteValueDictionary)	取得對應一組路由參數的網址。 (繼承來源 Control)
GetRouteUrl(String, Object)	取得對應一組路由參數和路由名稱的 URL。 (繼承來源 Control)
GetRouteUrl(String, RouteValueDictionary)	取得對應一組路由參數和路由名稱的 URL。 (繼承來源 Control)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
GetUniqueIDRelativeTo(Control)	回傳指定控制屬性的 UniqueID 前綴部分。 (繼承來源 Control)
HasControls()	判斷伺服器控制中是否包含任何子控制。 (繼承來源 Control)
HasEvents()	回傳一個值，表示事件是否被註冊為控制項或任何子控制項。 (繼承來源 Control)
IsLiteralContent()	判斷伺服器控制是否只儲存字面內容。 (繼承來源 Control)
LoadControlState(Object)	還原方法儲存 SaveControlState() 的先前頁面請求中的控制狀態資訊。 (繼承來源 Control)
LoadViewState(Object)	還原先前由該方法儲存的 SaveViewState() 頁面請求中的檢視狀態資訊。 (繼承來源 Control)
MapPathSecure(String)	擷取虛擬路徑（絕對或相對）所對應的物理路徑。 (繼承來源 Control)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
OnBubbleEvent(Object, EventArgs)	判斷伺服器控制事件是否會向上傳遞至頁面的 UI 伺服器控制階層。 (繼承來源 Control)
OnDataBinding(EventArgs)	引發 DataBinding 事件。 (繼承來源 Control)
OnInit(EventArgs)	引發 Init 事件。 (繼承來源 Control)
OnLoad(EventArgs)	引發 Load 事件。 (繼承來源 Control)
OnPreRender(EventArgs)	引發 PreRender 事件。 (繼承來源 Control)
OnUnload(EventArgs)	引發 Unload 事件。 (繼承來源 Control)
OpenFile(String)	用 Stream 來讀取檔案。 (繼承來源 Control)
RaiseBubbleEvent(Object, EventArgs)	將事件來源及其資訊指派給控制的父節點。 (繼承來源 Control)
RemovedControl(Control)	在子控制從物件集合Controls中Control移除後呼叫。 (繼承來源 Control)
Render(HtmlTextWriter)	寫入內容，在客戶端渲染到指定的 HtmlTextWriter 物件。 (繼承來源 HtmlControl)
RenderAttributes(HtmlTextWriter)	將 HtmlImage 控制項的屬性渲染到指定的 HtmlTextWriter 物件上。
RenderBeginTag(HtmlTextWriter)	將控制項的開頭 HTML 標籤渲染成指定的 HtmlTextWriter 物件。 (繼承來源 HtmlControl)
RenderChildren(HtmlTextWriter)	將伺服器控制子節點的內容輸出到所提供 HtmlTextWriter 物件，該物件會寫入要在用戶端渲染的內容。 (繼承來源 Control)
RenderControl(HtmlTextWriter, ControlAdapter)	伺服器控制內容輸出給所提供的 HtmlTextWriter 物件，使用該物件 ControlAdapter 。 (繼承來源 Control)
RenderControl(HtmlTextWriter)	將伺服器控制內容輸出給所提供 HtmlTextWriter 物件，並在啟用追蹤時儲存關於控制項的追蹤資訊。 (繼承來源 Control)
ResolveAdapter()	取得負責渲染指定控制的控制介面卡。 (繼承來源 Control)
ResolveClientUrl(String)	會取得瀏覽器可以使用的網址。 (繼承來源 Control)
ResolveUrl(String)	將一個網址轉換成請求客戶端可用的網址。 (繼承來源 Control)
SaveControlState()	將自頁面發布以來發生的任何伺服器控制狀態變更，都儲存回伺服器。 (繼承來源 Control)
SaveViewState()	將自頁面發布以來發生的任何伺服器控制權視圖狀態變更，都保存回伺服器。 (繼承來源 Control)
SetAttribute(String, String)	設定控制項上 HtmlControl 所命名屬性的值。 (繼承來源 HtmlControl)
SetDesignModeState(IDictionary)	為控制組設定設計時資料。 (繼承來源 Control)
SetRenderMethodDelegate(RenderMethod)	指派一個事件處理代理，將伺服器控制權及其內容渲染到其父控制中。 (繼承來源 Control)
SetTraceData(Object, Object, Object)	設定追蹤資料，用於設計時追蹤渲染資料，使用追蹤物件、追蹤資料鍵及追蹤資料值。 (繼承來源 Control)
SetTraceData(Object, Object)	使用軌跡資料鍵與痕跡資料值，設定繪圖資料以進行設計時追蹤渲染資料。 (繼承來源 Control)
ToString()	傳回表示目前物件的字串。 (繼承來源 Object)
TrackViewState()	會追蹤伺服器控制項的視圖狀態變更，使其能儲存在伺服器控制項的 StateBag 物件中。此物件可透過屬性 ViewState 存取。 (繼承來源 Control)

事件

名稱	Description
DataBinding	當伺服器控制項綁定到資料來源時會發生。 (繼承來源 Control)
Disposed	當伺服器控制從記憶體中釋放時發生，這是伺服器控制生命週期中請求 ASP.NET 頁面的最後階段。 (繼承來源 Control)
Init	發生在伺服器控制初始化時，這是其生命週期的第一步。 (繼承來源 Control)
Load	當伺服器控制項載入 Page 物件時會發生。 (繼承來源 Control)
PreRender	發生在物件載入後 Control 但渲染之前。 (繼承來源 Control)
Unload	當伺服器控制項從記憶體卸載時發生。 (繼承來源 Control)

明確介面實作

名稱	Description
IAttributeAccessor.GetAttribute(String)	關於此成員的描述，請參見 GetAttribute(String)。 (繼承來源 HtmlControl)
IAttributeAccessor.SetAttribute(String, String)	關於此成員的描述，請參見 SetAttribute(String, String)。 (繼承來源 HtmlControl)
IControlBuilderAccessor.ControlBuilder	關於此成員的描述，請參見 ControlBuilder。 (繼承來源 Control)
IControlDesignerAccessor.GetDesignModeState()	關於此成員的描述，請參見 GetDesignModeState()。 (繼承來源 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	關於此成員的描述，請參見 SetDesignModeState(IDictionary)。 (繼承來源 Control)
IControlDesignerAccessor.SetOwnerControl(Control)	關於此成員的描述，請參見 SetOwnerControl(Control)。 (繼承來源 Control)
IControlDesignerAccessor.UserData	關於此成員的描述，請參見 UserData。 (繼承來源 Control)
IDataBindingsAccessor.DataBindings	關於此成員的描述，請參見 DataBindings。 (繼承來源 Control)
IDataBindingsAccessor.HasDataBindings	關於此成員的描述，請參見 HasDataBindings。 (繼承來源 Control)
IExpressionsAccessor.Expressions	關於此成員的描述，請參見 Expressions。 (繼承來源 Control)
IExpressionsAccessor.HasExpressions	關於此成員的描述，請參見 HasExpressions。 (繼承來源 Control)
IParserAccessor.AddParsedSubObject(Object)	關於此成員的描述，請參見 AddParsedSubObject(Object)。 (繼承來源 Control)

擴充方法

名稱	Description
FindDataSourceControl(Control)	回傳與指定控制項相關聯的資料來源。
FindFieldTemplate(Control, String)	回傳指定控制項命名容器中指定欄位的欄位範本。
FindMetaTable(Control)	回傳包含資料控制項的元值物件。

適用於

另請參閱

意見反應

此頁面對您有幫助嗎？