AdRotator 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在網頁上顯示廣告橫幅。
public ref class AdRotator : System::Web::UI::WebControls::WebControlpublic ref class AdRotator : System::Web::UI::WebControls::DataBoundControlpublic class AdRotator : System.Web.UI.WebControls.WebControlpublic class AdRotator : System.Web.UI.WebControls.DataBoundControltype AdRotator = class
inherit WebControltype AdRotator = class
inherit DataBoundControlPublic Class AdRotator
Inherits WebControlPublic Class AdRotator
Inherits DataBoundControl- 繼承
- 繼承
範例
下列程式碼範例示範如何使用 AdRotator 控制項在網頁上顯示廣告橫幅。
<%@ 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 檔案的檔案格式，其中包含上一個範例的廣告資訊。 如需檔案格式的詳細資訊，請參閱 AdvertisementFile 成員。
<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>
</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>
</Ad>
</Advertisements>
備註
本主題內容：
簡介
AdRotator使用 控制項在網頁上顯示隨機選取的廣告橫幅。 每當頁面重新整理時，顯示的公告就會變更。
廣告資訊會儲存在個別的 XML 檔案中。 XML 檔案可讓您維護廣告清單及其相關聯的屬性。 屬性包括要顯示的影像路徑、按一下控制項時所要連結的 URL、當影像無法使用時要顯示的替代文字、關鍵字，以及廣告的頻率。 控制項不會驗證 AdRotator 此檔案中的資訊。 若要防止廣告執行惡意腳本，您應該一律先檢查資料再發行，或只接受來自信任來源的廣告資訊。
若要保護您的廣告檔案免于未經授權的網際網路存取，請執行下列一或多個動作：
- 將其儲存在App_Data目錄中，其設定為拒絕任何類型檔案的網際網路存取。
- 將副檔名重新命名為未.xml，並將副檔名對應至
HttpForbiddenHandlerWeb.config 中的 。如需詳細資訊，請參閱 Machine.config 檔案中的 一httpHandlers節。
除了 XML 檔案做為資料來源，也可以透過回呼事件提供廣告資訊。 這個事件也可以與 XML 檔案搭配使用，以擴充控制項的行為 AdRotator ，例如重新導向至另一個頁面。 AdvertisementFile如需檔案格式的其他資訊，請參閱 屬性。
XML 廣告檔案格式
控制項 AdRotator 會使用個別的 XML 公告檔案來儲存廣告資訊，例如要顯示的影像位置，以及要連結的頁面 URL。 AdvertisementFile控制項的 AdRotator 屬性會指定這個檔案的路徑。
建立廣告檔案時，開啟和結尾 <Advertisements> 標記會分別標示檔案的開頭和結尾。 開啟和關閉 <Ad> 標籤會分隔每個廣告。 所有廣告都會巢狀于開頭和結尾 <Advertisements> 標記之間。 如果檔案包含多個 <Advertisements> 標記，則控制項只會剖析 AdRotator 檔案中的第一組 <Advertisements> 標記。 將會忽略所有其他 <Advertisements> 標記。
每個廣告的資料元素都是在開頭和結尾 <Ad> 標記之間巢狀。 雖然某些資料元素是預先定義的 (，例如 ImageUrl 和 NavigateUrl) ，但您可以在標記之間 <Ad> 放置自訂元素。 這些元素會在剖析檔案時由 AdRotator 控制項讀取。 資訊接著會傳遞至 AdCreated 字典屬性中的 AdProperties 事件。
下表列出針對 XML 公告檔案預先定義的資料元素。
| 元素 | 描述 |
|---|---|
ImageUrl |
影像檔案的絕對或相對 URL (選擇性) 。 |
NavigateUrl |
如果使用者按一下廣告 (選擇性) ，則要連結的頁面 URL。
注意： 如果未設定這個專案， HRef 則屬性不會在錨點標記上呈現。 |
Height |
影像的高度，以圖元為單位， (選擇性) 。 |
Width |
影像的寬度，以圖元為單位， (選擇性) 。 |
AlternateText |
當屬性指定的 ImageUrl 影像無法使用時，文字顯示會取代影像， (選擇性) 。 在某些瀏覽器中，此文字也會顯示為 ToolTip 廣告的 。 |
Keyword |
廣告 (的類別，例如「電腦」) ，您可以依 (選擇性) 進行篩選。 |
Impressions |
數位，指出相對於檔案中其他廣告的排程中廣告的重要性， (選擇性) 。 數位越大，廣告的顯示頻率就越高。 XML 檔案中所有 <Impressions> 值的總數不能超過 2，047，999，999。 如果這樣做，控制項 AdRotator 會擲回執行時間例外狀況。 |
下列範例顯示 XML 公告檔案的格式。
<Advertisements>
<Ad>
<ImageUrl>
URL of image to display for Advertisement #1
</ImageUrl>
<NavigateUrl>
URL of page to link to for Advertisement #1
</NavigateUrl>
<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>
宣告式語法
<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"
NavigateUrlField="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() |
初始化 AdRotator 類別的新執行個體。 |
屬性
| AccessKey |
取得或設定便捷鍵 (Access Key)，可讓您快速巡覽至 Web 伺服器控制項。 (繼承來源 WebControl) |
| Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
| AdvertisementFile |
取得或設定含有廣告資訊的 XML 檔的路徑。 |
| AlternateTextField |
取得或設定自訂資料欄位，以便取代廣告的 |
| AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
| Attributes |
取得任意屬性 (Attribute) 的集合 (只供呈現)，不與控制項上的屬性 (Property) 對應。 (繼承來源 WebControl) |
| BackColor |
取得或設定 Web 伺服器控制項的背景色彩。 (繼承來源 WebControl) |
| BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
| BorderColor |
取得或設定 Web 控制項的框線色彩。 (繼承來源 WebControl) |
| BorderStyle |
取得或設定 Web 伺服器控制項的框線樣式。 (繼承來源 WebControl) |
| BorderWidth |
取得或設定 Web 伺服器控制項的框線寬度。 (繼承來源 WebControl) |
| ChildControlsCreated |
取得值，指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
| ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
取得字元值，表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
| Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
| Controls |
取得 ControlCollection 物件，表示 UI 階層架構中指定之伺服器控制項的子控制項。 (繼承來源 Control) |
| ControlStyle |
取得 Web 伺服器控制項的樣式。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| ControlStyleCreated |
取得值，指出 Style 物件是否已經為 ControlStyle 屬性建立。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| CssClass |
取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。 (繼承來源 WebControl) |
| DataItemContainer |
如果命名容器實作 IDataItemContainer，則取得命名容器的參考。 (繼承來源 Control) |
| DataKeysContainer |
如果命名容器實作 IDataKeysControl，則取得命名容器的參考。 (繼承來源 Control) |
| DataMember |
取得或設定資料繫結控制項繫結至的資料清單名稱 (如果資料來源包含多個不同資料項目清單)。 (繼承來源 DataBoundControl) |
| DataSource |
取得或設定資料繫結控制項從中擷取其資料項目清單的物件。 (繼承來源 BaseDataBoundControl) |
| DataSourceID |
取得或設定控制項的識別碼，資料繫結控制項會由此擷取其項目清單。 (繼承來源 DataBoundControl) |
| DataSourceObject |
取得物件，這個物件會實作可提供物件資料內容之存取權的 IDataSource 介面。 (繼承來源 DataBoundControl) |
| DesignMode |
取得值，指出控制項是否正用於設計介面上。 (繼承來源 Control) |
| Enabled |
取得或設定值，指出 Web 伺服器控制項是否啟用。 (繼承來源 WebControl) |
| EnableTheming |
取得或設定值，指出佈景主題是否套用至此控制項。 (繼承來源 WebControl) |
| EnableViewState |
取得或設定值，該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態，以及它包含的任何子控制項狀態。 (繼承來源 Control) |
| Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 Control) |
| Font |
取得與廣告橫幅控制項關聯的字型屬性。 |
| ForeColor |
取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。 (繼承來源 WebControl) |
| HasAttributes |
取得值，指出控制項是否已經設定屬性。 (繼承來源 WebControl) |
| HasChildViewState |
取得值，指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承來源 Control) |
| Height |
取得或設定 Web 伺服器控制項的高度。 (繼承來源 WebControl) |
| ID |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
| IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 Control) |
| ImageUrlField |
取得或設定自訂資料欄位，以便取代廣告的 |
| Initialized |
取得值，指出是否已初始化資料繫結控制項。 (繼承來源 BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
取得值，指出是否已設定 DataSourceID 屬性。 (繼承來源 BaseDataBoundControl) |
| IsChildControlStateCleared |
取得值，指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承來源 Control) |
| IsDataBindingAutomatic |
取得值，指出資料繫結是否為自動。 (繼承來源 BaseDataBoundControl) |
| IsEnabled |
取得值，指出是否啟用控制項。 (繼承來源 WebControl) |
| IsTrackingViewState |
取得值，指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承來源 Control) |
| IsUsingModelBinders |
取得值，指出模型繫結是否正在使用。 (繼承來源 DataBoundControl) |
| IsViewStateEnabled |
取得值，指出這個控制項是否已啟用檢視狀態。 (繼承來源 Control) |
| ItemType |
取得或設定強型別資料繫結的資料項目型別名稱。 (繼承來源 DataBoundControl) |
| KeywordFilter |
取得或設定分類關鍵字，以篩選 XML 廣告檔中特定類型的廣告。 |
| LoadViewStateByID |
取得值，指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承來源 Control) |
| NamingContainer |
取得伺服器控制項命名容器的參考，其建立唯一命名空間，在具有相同 ID 屬性值的伺服器控制項之間作區別。 (繼承來源 Control) |
| NavigateUrlField |
取得或設定自訂資料欄位，以便取代廣告的 |
| Page |
取得含有伺服器控制項的 Page 執行個體的參考。 (繼承來源 Control) |
| Parent |
在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承來源 Control) |
| RenderingCompatibility |
取得值，這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承來源 Control) |
| RequiresDataBinding |
取得或設定值，指出是否應該呼叫 DataBind() 方法。 (繼承來源 BaseDataBoundControl) |
| SelectArguments |
取得 DataSourceSelectArguments 物件，當從資料來源控制項擷取資料時資料繫結控制項會使用它。 (繼承來源 DataBoundControl) |
| SelectMethod |
為了讀取資料要呼叫的方法的名稱。 (繼承來源 DataBoundControl) |
| Site |
當呈現在設計介面上時，取得裝載目前控制項之容器的資訊。 (繼承來源 Control) |
| SkinID |
取得或設定要套用至控制項的面板。 (繼承來源 WebControl) |
| Style |
取得文字屬性的集合，將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。 (繼承來源 WebControl) |
| SupportsDisabledAttribute |
取得值，這個值表示當控制項的 |
| SupportsDisabledAttribute |
取得值，這個值表示當控制項的 |
| TabIndex |
取得或設定 Web 伺服器控制項的定位索引。 (繼承來源 WebControl) |
| TagKey |
取得 AdRotator 控制項的 HTML 標記。 |
| TagKey |
取得對應至這個 Web 伺服器控制項的 HtmlTextWriterTag 值。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| TagName |
取得控制項標記的名稱。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| Target |
取得或設定瀏覽器視窗或框架 (Frame) 的名稱，此視窗或框架會顯示當按一下 AdRotator 控制項時，Web 網頁所連結的內容。 |
| TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
| ToolTip |
取得或設定當滑鼠指標停留在 Web 伺服器控制項時顯示的文字。 (繼承來源 WebControl) |
| UniqueID |
取得 AdRotator 控制項唯一且符合階層架構的識別項。 |
| UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
| ValidateRequestMode |
取得或設定值，指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
| ViewState |
取得狀態資訊的字典，允許您在相同網頁的多個要求之間，儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
| ViewStateIgnoresCase |
取得值，指出 StateBag 物件是否不區分大小寫。 (繼承來源 Control) |
| ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定值，指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
| Width |
取得或設定 Web 伺服器控制項的寬度。 (繼承來源 WebControl) |
方法
事件
| AdCreated |
在控制項建立之後，但在網頁呈現之前，每來回伺服器一趟即發生一次。 |
| CallingDataMethods |
正在呼叫資料方法時發生。 (繼承來源 DataBoundControl) |
| CreatingModelDataSource |
正在建立 ModelDataSource 物件時發生。 (繼承來源 DataBoundControl) |
| DataBinding |
發生於伺服器控制項繫結至資料來源時。 (繼承來源 Control) |
| DataBound |
在伺服器控制項繫結至資料來源之後發生。 (繼承來源 BaseDataBoundControl) |
| Disposed |
發生於伺服器控制項從記憶體釋放時，這是在要求 ASP.NET 網頁時，伺服器控制項生命週期的最後階段。 (繼承來源 Control) |
| Init |
發生於初始化伺服器控制項時，是其生命週期中的第一個步驟。 (繼承來源 Control) |
| Load |
發生於載入伺服器控制項至 Page 物件時。 (繼承來源 Control) |
| PreRender |
在 Control 物件載入之後但在呈現之前發生。 (繼承來源 Control) |
| Unload |
發生於伺服器控制項從記憶體卸載時。 (繼承來源 Control) |
明確介面實作
擴充方法
| EnablePersistedSelection(BaseDataBoundControl) |
已淘汰.
啟用要保存於資料控制項中且支援選取和分頁的選項。 |
| FindDataSourceControl(Control) |
傳回與指定之控制項的資料控制項相關聯的資料來源。 |
| FindFieldTemplate(Control, String) |
傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 |
| FindMetaTable(Control) |
傳回包含資料控制項的中繼資料表物件。 |
