AdCreatedEventArgs.ImageUrl プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

AdRotator コントロールに表示するイメージの URL を取得または設定します。

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

プロパティ値

String

AdRotator コントロールに表示するイメージの URL。 既定値は Empty です。

例

次のコード例では、 プロパティをプログラムで設定する方法を ImageUrl 示します。

<%@ 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 runat="server">
    <title>AdCreatedEventArgs ImageUrl Example</title>
<script runat="server">
   
       void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
       {

          e.ImageUrl = "images/newimage.jpg";   
       
       }      

   </script>
 
</head>
 
<body>
 
   <form id="form1" runat="server">
 
      <h3>AdCreatedEventArgs ImageUrl Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </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 runat="server">
    <title>AdCreatedEventArgs ImageUrl Example</title>
<script runat="server">
   
       Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 
       
          e.ImageUrl = "images/newimage.jpg"   
       
       End Sub      

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

次のコード例では、提供情報を含む XML ファイルの書式を設定する方法を示します。 XML ファイルの詳細については、 クラスの プロパティをAdvertisementFileAdRotator参照してください。

<Advertisements>  
 <Ad>  
 <ImageUrl>image1.jpg</ImageUrl>  
 <NavigateUrl>http://www.microsoft.com</NavigateUrl>  
 <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>  
 <NavigateUrl>http://www.wingtiptoys.com</NavigateUrl>  
 <AlternateText>Wingtip Toys</AlternateText>  
 <Impressions>80</Impressions>  
 <Keyword>Topic2</Keyword>  
 <Caption>This is the caption for Ad#2</Caption>   
 </Ad>  
</Advertisements>

注釈

プロパティを ImageUrl 使用して、コントロール内の提供情報に表示するイメージの URL を AdRotator 指定します。 相対 URL または絶対 URL を使用できます。 相対 URL は、サーバー上の完全なパスを指定せずに、イメージの場所を Web ページまたはユーザー コントロールの場所に関連付けます。 パスは、Web ページの場所に対する相対パスです。 これにより、コード内のイメージへのパスを更新することなく、サイト全体をサーバー上の別のディレクトリに簡単に移動できます。 絶対 URL は完全なパスを提供するため、サイトを別のディレクトリに移動するにはコードを更新する必要があります。

別の XML ファイルには、表示されるアドバタイズのプロパティが含まれています。 コントロールは AdRotator 、アドバタイズ情報を ImageUrl 含む XML ファイル内の対応する画像 URL エントリを使用して、 プロパティを自動的に設定します。 このプロパティを使用して、イメージの URL をプログラムで設定することもできます。

Note

アドバタイズ ファイルを使用し、このプロパティの相対 URL を指定した場合、URL はアドバタイズファイルが配置されているディレクトリに対する相対 URL になります。 アドバタイズ ファイルを使用する代わりに、相対 URL を使用してこのプロパティを直接設定した場合、URL は、コントロールを含む AdRotator ページ またはユーザー コントロールのディレクトリを基準とします。

適用対象

こちらもご覧ください