AdRotator.AlternateTextField プロパティ

定義

広告の AlternateText 属性の代わりに使用するカスタム データ フィールドを取得または設定します。

public:
 property System::String ^ AlternateTextField { System::String ^ get(); void set(System::String ^ value); };
public string AlternateTextField { get; set; }
member this.AlternateTextField : string with get, set
Public Property AlternateTextField As String

プロパティ値

String

広告の代替テキストが格納されているフィールドを識別する名前。 既定値は "AlternateText" です。

次のコード例では、プロパティを AlternateTextField 使用してカスタム データ フィールドを指定する方法を示します。 、NavigateUrlFieldImageUrlFieldおよびAlternateTextFieldプロパティは、およびAlternateText属性の代わりに使用するユーザー設定フィールドを動的にNavigateUrl``ImageUrl選択するために使用されます。 この例では、デバイス フィルターを使用して、ワイヤレス アプリケーション プロトコル (WAP) が有効なデバイスにカスタム フィールドを使用する必要があることを示します。

<%@ 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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">
  <div>
    <p>This example demonstrates using the AdRotator control.</p>
    <p>
      <asp:AdRotator ID="AdRotator1" Runat="server" 
        DataSourceID="Ads"
        Winwap:NavigateUrlField="WMLNavigateUrl"
        Winwap:ImageUrlField="WmlImageUrl"
        Winwap:AlternateTextField="WmlAlternateText"
      />
      <asp:XmlDataSource ID="Ads" 
        Runat="server" 
        DataFile="~/App_Data/AdvertisementList.xml">
      </asp:XmlDataSource>
    </p>
  </div>
  </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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">
  <div>
    <p>This example demonstrates using the AdRotator control.</p>
    <p>
      <asp:AdRotator ID="AdRotator1" Runat="server" 
        DataSourceID="Ads"
        Winwap:NavigateUrlField="WMLNavigateUrl"
        Winwap:ImageUrlField="WmlImageUrl"
        Winwap:AlternateTextField="WmlAlternateText"
      />
      <asp:XmlDataSource ID="Ads" 
        Runat="server" 
        DataFile="~/App_Data/AdvertisementList.xml">
      </asp:XmlDataSource>
    </p>
  </div>
  </form>
</body>
</html>

前の例のサンプル XML データを次に示します。

<Advertisements>  
  <Ad>  
    <ImageUrl>~/Images/ad1.gif</ImageUrl>  
    <NavigateUrl>https://docs.microsoft.com/dotnet/visual-basic/</NavigateUrl>  
    <AlternateText>Visual Basic documentation</AlternateText>  
    <Width>140</Width>  
    <Height>100</Height>  
    <!-- The following custom elements will be used by WAP-enabled  
      devices. -->  
    <WmlImageUrl>~/Images/mobileAd1.jpg</WmlImageUrl>  
    <WmlNavigateUrl>https://msdn.microsoft.com/mobile/</WmlNavigateUrl>  
    <WmlAlternateText>Windows Mobile Developer Site</WmlAlternateText>  
  </Ad>  
  <Ad>  
    <ImageUrl>~/Images/ad2.gif</ImageUrl>  
    <NavigateUrl>https://docs.microsoft.com/</NavigateUrl>  
    <AlternateText>Docs</AlternateText>  
    <Width>150</Width>  
    <Height>150</Height>  
    <!-- The following custom elements will be used by WAP-enabled  
      devices. -->  
    <WmlImageUrl>~/Images/mobileAd2.jpg</WmlImageUrl>  
    <WmlNavigateUrl>https://msdn.microsoft.com/mobilibity/</WmlNavigateUrl>  
    <WmlAlternateText>Windows Mobile Developer Site</WmlAlternateText>  
  </Ad>  
</Advertisements>  

注釈

この AlternateTextField プロパティは、アドバタイズの属性の代わりに使用するカスタム データ フィールドを AlternateText 選択するために使用されます。 同様 AlternateTextに、このユーザー設定フィールドは、アドバタイズ情報を含む XML ファイルで定義されます。

適用対象

こちらもご覧ください