Image.AlternateText Image.AlternateText Image.AlternateText Image.AlternateText Property

定義

イメージが使用できない場合に Image コントロールに表示される代替テキストを取得または設定します。Gets or sets the alternate text displayed in the Image control when the image is unavailable. ツール ヒント機能をサポートしているブラウザーの場合、このテキストはツール ヒントとして表示されます。Browsers that support the ToolTips feature display this text as a ToolTip.

public:
 virtual property System::String ^ AlternateText { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual string AlternateText { get; set; }
member this.AlternateText : string with get, set
Public Overridable Property AlternateText As String

プロパティ値

イメージが使用できない場合に Image コントロールに表示される代替テキスト。The alternate text displayed in the Image control when the image is unavailable.

次の例は、 AlternateTextプロパティを使用して、イメージが使用できないときにイメージに対して表示する代替テキストを指定する方法を示しています。The following example demonstrates how to use the AlternateText property to specify the alternate text to display for the image when the image is not available.

<%@ 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プロパティで指定されたイメージが使用できない場合に表示するテキストを指定するには、このプロパティを使用します。Use this property to specify the text to display if the image specified in the ImageUrl property is not available. ツールヒント機能をサポートするブラウザーでは、このテキストもツールヒントとして表示されます。In browsers that support the ToolTips feature, this text also displays as a ToolTip.

このプロパティの値は、設定されると、デザイナーツールを使用してリソースファイルに自動的に保存できます。The value of this property, when set, can be saved automatically to a resource file by using a designer tool. 詳細についてはLocalizableAttribute 、「」および「 ASP.NET グローバリゼーション and ローカライゼーション」を参照してください。For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.

適用対象

こちらもご覧ください