AdRotator.AdvertisementFile 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定含有廣告資訊的 XML 檔的路徑。

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

屬性值

String

包含廣告資訊的 XML 檔的位置。 預設值為空字串 ("")。

屬性
BindableAttribute

範例

下列程式碼範例示範如何使用 AdvertisementFile 屬性來指定包含廣告資訊的 XML 檔案位置。

<%@ 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>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </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>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

下列程式碼範例顯示 XML 公告檔案的檔案格式。

<Advertisements>  
  <Ad>  
    <ImageUrl>~/Images/image1.jpg</ImageUrl>  
    <Height>60</Height>  
    <Width>190</Width>  
    <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>~/Images/image2.jpg</ImageUrl>  
    <Height>90</Height>  
    <Width>90</Width>  
    <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>

備註

AdvertisementFile使用 屬性來指定包含廣告資訊的 XML 檔案位置。 XML 檔案必須位於相同的網站內。 基於部署和安全性目的，強烈建議您將檔案放在相同的 Web 應用程式中。 只有在應用程式有足夠的信任時，才能存取位於相同網站上不同應用程式的 XML 檔案。

您可以將此屬性設定為絕對路徑或相對於 XML 檔案的路徑。 使用相對路徑來簡化部署。 如果您使用相對路徑，該路徑會相對於包含 AdRotator 控制項的頁面或使用者控制項的位置。

AdvertisementFile 是選用屬性。 您也可以以程式設計方式在 事件中 AdCreated 設定廣告。

XML 檔案包含下列預先定義的屬性。 ImageUrl只需要 屬性。

屬性 描述
ImageUrl 要顯示的影像 URL。
Height 影像的高度，以圖元為單位， (選擇性) 。
Width 影像的寬度，以圖元為單位， (選擇性) 。
NavigateUrl 按一下控制項時，要巡覽至頁面的 AdRotator URL。
AlternateText 如果影像無法使用，要顯示的文字。 在某些瀏覽器中，此文字會顯示為工具提示。
Keyword 廣告的類別。 控制項會 AdRotator 使用此清單來篩選特定類別的廣告清單。
Impressions 值，指出廣告相對於 XML 檔案中其他公告的顯示頻率。

注意

ImageUrl和 NavigateUrl 屬性可以是完整的 URL、根相對路徑或相對路徑。 如果您使用根相對路徑，則路徑會相對於相同的網站。 如果您使用相對路徑，路徑會相對於包含公告檔案的目錄。

您也可以在 XML 檔案中使用自訂標籤來包含自訂屬性。 所有屬性標籤都會從廣告檔案剖析，並將值放在字典中 AdProperties 。 您可以使用 AdProperties 字典，以程式設計方式存取您的自訂屬性。

控制項不會驗證 AdRotator 此檔案中的資訊。 若要防止廣告執行惡意腳本，您應該一律先檢查資料，再發行資料，或只接受來自信任來源的廣告資訊。

若要保護您的廣告檔案免于未經授權的網際網路存取，請執行下列一或多個動作：

  • 將它儲存在 [資料] 目錄中，該目錄設定于 Machine.config，以拒絕任何類型的檔案存取網際網路。
  • 將副檔名重新命名為未.xml，並將副檔名對應至 HttpForbiddenHandler Web.config。如需詳細資訊，請參閱 httpHandlers Machine.config 檔案中的 區段。

適用於

另請參閱