Image.AlternateText 属性
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置当图像不可用时，Image 控件中显示的替换文本。 支持工具提示功能的浏览器将此文本显示为工具提示。
public:
virtual property System::String ^ AlternateText { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Bindable(true)]
public virtual string AlternateText { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.AlternateText : string with get, setPublic Overridable Property AlternateText As String当图像不可用时，Image 控件中显示的替换文本。
- 属性
下面的示例演示如何使用 AlternateText 属性指定要在图像不可用时为图像显示的备用文本。
<%@ 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>
</head>
<body>
<form id="form1" runat="server">
<h3>Image Example</h3>
<asp:Image id="Image1" runat="server"
AlternateText="Image text"
ImageAlign="left"
ImageUrl="images/image1.jpg"/>
</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>
</head>
<body>
<form id="form1" runat="server">
<h3>Image Example</h3>
<asp:Image id="Image1" runat="server"
AlternateText="Image text"
ImageAlign="left"
ImageUrl="images/image1.jpg"/>
</form>
</body>
</html>
使用此属性可指定要在 属性中指定的 ImageUrl 图像不可用时显示的文本。 在支持工具提示功能的浏览器中，此文本还显示为工具提示。
设置此属性的值后，可以使用设计器工具自动保存到资源文件。 有关详细信息，请参阅 LocalizableAttribute 和 ASP.NET 全球化和本地化。
| 产品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
