HtmlImage 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 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
- 繼承
範例
下列程式碼範例示範如何在按一下 時 HtmlButton ,以程式設計方式修改控制項的屬性 HtmlImage 。
<%@ 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 構函式。
建構函式
HtmlImage() |
初始化 HtmlImage 類別的新執行個體。 |
屬性
Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
Align |
取得或設定影像相對於其他 Web 網頁項目的對齊方式。 |
Alt |
取得或設定瀏覽器在沒有影像或目前正在下載而尚未完成時,要顯示的替代標題。 |
AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
Attributes |
取得 ASP.NET 網頁內伺服器控制項標記上所表示,所有成對屬性名稱和值的集合。 (繼承來源 HtmlControl) |
BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
Border |
取得或設定影像框架 (Frame) 的寬度。 |
ChildControlsCreated |
取得值,指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
ClientIDSeparator |
取得字元值,表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
Controls |
取得 ControlCollection 物件,表示 UI 階層架構中指定之伺服器控制項的子控制項。 (繼承來源 Control) |
DataItemContainer |
如果命名容器實作 IDataItemContainer,則取得命名容器的參考。 (繼承來源 Control) |
DataKeysContainer |
如果命名容器實作 IDataKeysControl,則取得命名容器的參考。 (繼承來源 Control) |
DesignMode |
取得值,指出控制項是否正用於設計介面上。 (繼承來源 Control) |
Disabled |
取得或設定值,指出是否停用 HTML 伺服器控制項。 (繼承來源 HtmlControl) |
EnableTheming |
取得或設定值,指出佈景主題是否套用至此控制項。 (繼承來源 Control) |
EnableViewState |
取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。 (繼承來源 Control) |
Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 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 |
取得在 ASP.NET 檔案中套用到指定 HTML 伺服器控制項的所有階層式樣式表 (CSS) 屬性集合。 (繼承來源 HtmlControl) |
TagName |
取得標記項目名稱,其包含 |
TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
ValidateRequestMode |
取得或設定值,指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
ViewState |
取得狀態資訊的字典,允許您在相同網頁的多個要求之間,儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
ViewStateIgnoresCase |
取得值,指出 HtmlControl 檢視狀態是否區分大小寫。 (繼承來源 HtmlControl) |
ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
Visible |
取得或設定值,指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
Width |
取得或設定影像的寬度。 |
方法
事件
DataBinding |
發生於伺服器控制項繫結至資料來源時。 (繼承來源 Control) |
Disposed |
發生於伺服器控制項從記憶體釋放時,這是在要求 ASP.NET 網頁時,伺服器控制項生命週期的最後階段。 (繼承來源 Control) |
Init |
發生於初始化伺服器控制項時,是其生命週期中的第一個步驟。 (繼承來源 Control) |
Load |
發生於載入伺服器控制項至 Page 物件時。 (繼承來源 Control) |
PreRender |
在 Control 物件載入之後但在呈現之前發生。 (繼承來源 Control) |
Unload |
發生於伺服器控制項從記憶體卸載時。 (繼承來源 Control) |
明確介面實作
擴充方法
FindDataSourceControl(Control) |
傳回與指定之控制項的資料控制項相關聯的資料來源。 |
FindFieldTemplate(Control, String) |
傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 |
FindMetaTable(Control) |
傳回包含資料控制項的中繼資料表物件。 |