AdControl 類別

定義

命名空間:

Microsoft.Advertising.WinRT.UI

代表在應用程式中顯示橫幅廣告的控制項。

public ref class AdControl sealed : StackPanel, IClosable

/// [Windows.Foundation.Metadata.Activatable(1)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.Foundation.Metadata.WebHostHidden]
class AdControl final : StackPanel, IClosable

[Windows.Foundation.Metadata.Activatable(1)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.Foundation.Metadata.WebHostHidden]
public sealed class AdControl : StackPanel, System.IDisposable

Public NotInheritable Class AdControl
Inherits StackPanel
Implements IDisposable

繼承

StackPanel

AdControl

屬性

ActivatableAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute WebHostHiddenAttribute

實作

IClosable IDisposable

其他功能與需求

軟體開發套件	Microsoft Advertising SDK
支援 OS 的最低版本	Windows 10 (10.0.10240.0)

備註

如需示範如何使用此類型的逐步解說和程式碼範例，請參閱 GitHub 上的 XAML 和 .NET 中的 AdControl、 HTML 5 中的 AdControl 和 JavaScript 和 Advertising 範例。

建構函式

AdControl()

初始化 AdControl 類別的新實例。

屬性

AdUnitId	取得或設定這個 AdControl 物件的廣告單位識別碼。 此值可在合作夥伴中心取得。
ApplicationId	取得或設定這個 AdControl 物件的應用程式識別碼。 此值可在合作夥伴中心取得。
AutoRefreshIntervalInSeconds	取得或設定 AdControl 以秒為單位重新整理目前顯示的橫幅廣告的間隔。
CountryOrRegion	取得或設定使用者所在的兩個字母國家或地區代碼。
HasAd	取得值，指出 AdControl 目前是否正在提供橫幅廣告。
IsAutoRefreshEnabled	取得或設定值，這個值表示是否啟用橫幅廣告的自動輪替。
IsEngaged	取得值，指出使用者是否與橫幅廣告互動。
IsSuspended	取得值，這個值表示 AdControl 是否處於暫停狀態。
Keywords	取得或設定以廣告物件為目標的關鍵字。
PostalCode	取得或設定要設為橫幅廣告目標的郵遞區號。

方法

AddAdTag(String, String)	將廣告標籤新增至 AdControl。
Close()	釋放 控制項所使用的相關聯繫統資源。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
Refresh()	指示 AdControl 在新的廣告可用時顯示下一個廣告，如果停用自動重新整理。 目前呈現的廣告會維持不變，直到下一個廣告可供使用為止。
RemoveAdTag(String)	從 AdControl移除廣告標籤。
Resume()	在呼叫 Suspend之後繼續顯示橫幅廣告的正常顯示。
Suspend()	暫停目前的橫幅廣告，並將橫幅廣告的目前檢視取代為所呈現專案的靜態快照集。

事件

AdRefreshed	當 AdControl 收到新的橫幅廣告時引發。
ErrorOccurred	當 AdControl 遇到操作錯誤時引發。
IsEngagedChanged	當使用者按一下橫幅廣告，並與它互動，而不是應用程式時引發。
OnManipulationStateChanged	當 AdControl 收到橫幅廣告中的操作狀態變更事件時引發。
OnMouseWheel	當 AdControl 收到滑鼠滾輪事件時引發。
OnPointerDown	當使用者按一下、指向或觸碰橫幅廣告時引發。
OnPointerMove	移動指向裝置時引發。
OnPointerUp	當使用者停止按一下、指向或觸控橫幅廣告時引發。

另請參閱

• XAML 和 .NET 中的 AdControl
• HTML 5 和 JavaScript 中的 AdControl
• GitHub 上的廣告範例