次の方法で共有

AdCreatedEventArgs.AlternateText プロパティ

広告イメージが使用できない場合に AdRotator コントロールに表示される代替テキストを取得または設定します。ツール ヒント機能をサポートしているブラウザの場合、このテキストは広告のツール ヒントとして表示されます。

Public Property AlternateText As String
[C#]
public string AlternateText {get; set;}
[C++]
public: __property String* get_AlternateText();public: __property void set_AlternateText(String*);
[JScript]
public function get AlternateText() : String;public function set AlternateText(String);

プロパティ値

イメージが使用できない場合に、広告イメージの代わりに表示されるテキスト。既定値は String.Empty です。

解説

AlternateText プロパティを使用して、 ImageUrl プロパティで指定されたイメージが使用できない場合に表示するテキストを指定します。ツール ヒント機能をサポートしているブラウザの場合、このテキストは広告のツール ヒントとしても表示されます。

各 XML ファイルには、表示される広告のプロパティが含まれています。 AdRotator コントロールは、 AlternateText プロパティを XML ファイルの対応する代替テキスト エントリに自動的に設定します。このプロパティは、代替テキストをプログラムから設定するときにも使用できます。

使用例

[Visual Basic, C#, JScript] プログラムから AlternateText プロパティを設定する方法を次の例に示します。

 
<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
       Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 
       
          e.AlternateText = "New Alternate Text Value"   
       
       End Sub      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdCreatedEventArgs AlternateText Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
       void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
       {

          e.AlternateText = "New Alternate Text Value";   
       
       }      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdCreatedEventArgs AlternateText Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

[JScript] 
<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
       function AdCreated_Event(sender, e : AdCreatedEventArgs) 
       {

          e.AlternateText = "New Alternate Text Value";   
       
       }      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdCreatedEventArgs AlternateText Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

[Visual Basic, C#, JScript] 広告情報を含む XML ファイルの書式を設定する方法を次の例に示します。XML ファイルの詳細については、 AdRotator クラスの AdvertisementFile プロパティのトピックを参照してください。

<Advertisements>
 
 <Ad>
 <ImageUrl>image1.jpg</ImageUrl>
 <href>https://www.microsoft.com</href>
 <AlternateText>Microsoft Main Site</AlternateText>
 <Impressions>80</Impressions>
 <Keyword>Topic1</Keyword>
 <Caption>This is the caption for Ad#1</Caption> 
 </Ad>
 
 <Ad>
 <ImageUrl>image2.jpg</ImageUrl>
 <href>http://www.wingtiptoys.com</href>
 <AlternateText>Wing Tip Toys</AlternateText>
 <Impressions>80</Impressions>
 <Keyword>Topic2</Keyword>
 <Caption>This is the caption for Ad#2</Caption> 
 </Ad>
 
</Advertisements>

[C++] C++ のサンプルはありません。Visual Basic、C#、および JScript のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

参照

AdCreatedEventArgs クラス | AdCreatedEventArgs メンバ | System.Web.UI.WebControls 名前空間 | AdRotator | ImageUrl | AdvertisementFile | String.Empty