共用方式為

AdRotator Web 伺服器控制項宣告式語法

  • 發行項

更新：2007 年 11 月

在 Web Form 網頁上顯示廣告橫幅。

 <asp:AdRotator     AccessKey="string"     AdvertisementFile="uri"     AlternateTextField="string"     BackColor="color name|#dddddd"     BorderColor="color name|#dddddd"     BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|         Inset|Outset"     BorderWidth="size"     CssClass="string"     DataMember="string"     DataSource="string"     DataSourceID="string"     Enabled="True|False"     EnableTheming="True|False"     EnableViewState="True|False"     ForeColor="color name|#dddddd"     Height="size"     ID="string"     ImageUrlField="string"     KeywordFilter="string"     hrefField="string"     OnAdCreated="AdCreated event handler"     OnDataBinding="DataBinding event handler"     OnDataBound="DataBound event handler"     OnDisposed="Disposed event handler"     OnInit="Init event handler"     OnLoad="Load event handler"     OnPreRender="PreRender event handler"     OnUnload="Unload event handler"     runat="server"     SkinID="string"     Style="string"     TabIndex="integer"     Target="string|_blank|_parent|_search|_self|_top"     ToolTip="string"     Visible="True|False"     Width="size" />

備註

AdRotator 控制項會在 Web Form 網頁上顯示廣告橫幅。它會顯示錨點控制項內 ImageUrl 項目所指定的影像。在執行階段時，AdRotator 控制項會使用 <asp:HyperLink> 和 <asp:Image> 控制項呈現 Web Form 網頁上的控制項。不論影像的實際大小為何，瀏覽器都會將來源影像調整成 AdRotator 控制項的尺寸。

如果設定了 AdvertisementFile 屬性，就會依據 <Impressions> 屬性的值從檔案中選取廣告。然後便會設定事件引數並引發 AdCreated 事件。如果沒有設定 AdvertisementFile 屬性，在引發 AdCreated 事件時，事件引數就會是空的。事件引數是用以呈現 AdRotator 控制項，所以您可以從廣告檔修改傳遞給事件的值，或者用您自己產生的值來設定它們。有種常見的案例是使用從資料庫擷取的值來填入 (Populate) 事件引數。

當您建立廣告檔時，請考量下列幾點：

  • 廣告檔中的 XML 必須是語式正確 (Well-Formed)。

  • AdRotator 控制項只會剖析檔案中的第一個 <Advertisements> 項目。檔案中所有其他 <Advertisements> 項目都會被忽略。

  • 您可以將自訂項目加入廣告的 XML 描述。這些值都會傳遞至 AdProperties 字典屬性中的 AdCreated 事件。

您可以使用 AdCreated 事件在您的程式碼中直接選取廣告，或者修改從廣告檔所選取之廣告的呈現。如果設定了廣告檔，當呼叫 AdCreated 事件時，其引數已經設定為所選取的廣告。不論是否已經設定這些值，您都可以修改 ImageUrl、href 和 AlternateText 屬性中的值，以修改 AdRotator 控制項的呈現。加入廣告 XML 描述的自訂項目都會出現在 AdCreatedEventArgs.AdProperties 字典屬性中。

如需 AdRotator 控制項之屬性和事件的詳細資訊，請參閱 AdRotator 文件。

廣告檔格式

AdRotator 控制項使用一個單獨的 XML 廣告檔來儲存廣告資訊，例如所要顯示之影像的位置以及所要連結之網頁的 URL。AdRotator 控制項的 AdvertisementFile 屬性指定此檔案的路徑。

建立廣告檔時，開頭和結尾的 <Advertisements> 標記分別標記了檔案的開頭和結尾。開頭和結尾 <Ad> 標記則是分隔每個廣告。所有的廣告都以巢狀方式置於開頭和結尾的 <Advertisements> 標記之間。如果檔案中含有多個 <Advertisements> 標記，只有檔案中的第一組 <Advertisements> 標記會被 AdRotator 控制項剖析。所有其他的 <Advertisements> 標記都會被忽略。

每個廣告的資料項目都是以巢狀方式置於開頭和結尾的 <Ad> 標記之間。雖然某些資料項目是預先定義的 (例如 ImageUrl 和 href)，不過您可以將自訂項目置於 <Ad> 標記之間。AdRotator 控制項在剖析檔案的時候，就會讀取這些項目。然後相關資訊就會傳遞至 AdProperties 字典屬性中的 AdCreated 事件。

下表所列是對 XML 廣告檔預先定義的資料項目。

項目

說明

<ImageUrl>

影像檔的絕對或相對 URL (選擇項)。

<href>

當使用者按一下廣告時所要連結之網頁的 URL (選擇項)。

注意事項：

如果沒有設定這個項目，就不會將 HRef 屬性呈現在錨點標記上。

<AlternateText>

當 ImageUrl 屬性所指定的影像不能使用時，會替代影像而顯示的文字 (選擇項)。

在某些瀏覽器中，這些文字也會顯示為廣告的 ToolTip。

<Keyword>

您可以用來篩選的廣告分類，例如 "Computers" (選擇項)。

<Impressions>

數值，表示這個廣告在輪換排程中相對於檔案中其他廣告之重要性 (選擇項)。

數值愈大，廣告顯示的次數愈多。XML 檔中的所有 <Impressions> 總值不能超過 2,047,999,999。如果超過，AdRotator 控制項便會擲回執行階段例外狀況。

以下所示為 XML 廣告檔的格式。

<Advertisements>
   <Ad>
      <ImageUrl>
         URL of image to display for Advertisement #1
      </ImageUrl>
      <href>
         URL of page to link to for Advertisement #1
      </href>
      <AlternateText>
         Text to show as a ToolTip for Advertisement #1
      </AlternateText>
      <Keyword>
         Keyword used to filter for Advertisement #1
      </Keyword>
      <Impressions>
         Relative importance of Advertisement #1
      </Impressions>
      <CustomInformation>
         Custom Data about Advertisement #1
      </CustomInformation>
   </Ad>
</Advertisements>

範例

下列範例示範如何在 .aspx 檔案中宣告 AdRotator 控制項。

<html>
 
   <head>
   </head>
 
<body>
   <form runat="server">
 
      <h3>AdRotator Example</h3>
 
      <asp:AdRotator id="AdRotator1"
           Target="_self"
           AdvertisementFile="Ads.xml"
           runat="server"/>
 
   </form>
</body>
 
</html>

下列範例示範如何建立 AdCreated 事件的事件處理常式，以程式設計的方式覆寫 href 屬性的值。

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

<html>
<head>

   <script runat="server">
   
      Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 

         e.href = "https://www.microsoft.com"   
       
      End Sub      

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

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

<html>
<head>

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

         e.href = "https://www.microsoft.com";   
       
      }      

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

下列範例是示範如何將 XML 廣告檔格式化。

<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>

請參閱

參考

AdRotator

其他資源

Web 伺服器控制項語法