HtmlImage 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供对服务器上 HTML <img> 元素的编程访问。
public ref class HtmlImage : System::Web::UI::HtmlControls::HtmlControlpublic class HtmlImage : System.Web.UI.HtmlControls.HtmlControltype HtmlImage = class
inherit HtmlControlPublic 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 |
获取或设置图像相对于其他网页元素的对齐方式。 |
| Alt |
获取或设置在图像不可用或当前正在下载且尚未完成的情况下浏览器显示的替换标题。 |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 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 |
为当前 Web 请求获取与服务器控件关联的 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 |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 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) |
返回包含数据控件的元表对象。 |
