XAML 和 C# 疑难解答指南

项目
07/13/2023

警告

自 2020 年 6 月 1 日起，适用于 Windows UWP 应用的 Microsoft 广告盈利平台将关闭。了解详细信息

本主题包含 XAML 应用中有关 Microsoft Advertising 库的常见开发问题的解决方案。

XAML
C#

XAML

AdControl 不显示

确保在 Package.appxmanifest 中选择“Internet (客户端)”功能。
检查应用程序 ID 和广告单元 ID。这些 ID 必须匹配在合作伙伴中心中获取的应用程序 ID 和广告单元 ID。有关详细信息，请参阅在应用中设置广告单元。
```
<UI:AdControl AdUnitId="{AdUnitID}" ApplicationId="{ApplicationID}"
              Width="728" Height="90" />
```

查看 Height 和 Width 属性。这些属性必须设置为横幅广告的受支持广告大小之一。

<UI:AdControl AdUnitId="{AdUnitID}"
              ApplicationId="{ApplicationID}"
              Width="728" Height="90" />

检查元素位置。 AdControl 必须在可视区域内。

检查 Visibility 属性。可选 Visibility 属性禁止设置为折叠或隐藏。此属性可内联设置（如下所示）或在外部样式表中设置。

<UI:AdControl AdUnitId="{AdUnitID}"
              ApplicationId="{ApplicationID}"
              Visibility="Visible"
              Width="728" Height="90" />

查看 AdControl 的父元素。如果 AdControl 元素驻留在父元素中，则父元素必须处于活动状态且可见。

<StackPanel>
    <UI:AdControl AdUnitId="{AdUnitID}"
                  ApplicationId="{ApplicationID}"
                  Width="728" Height="90" />
</StackPanel>

确保 AdControl 在视口中可见。 AdControl 必须可见才能正确显示广告。
ApplicationId 和 AdUnitId 的动态值不应在仿真器中测试。若要确保 AdControl 正常运行，请使用 ApplicationId 和 AdUnitId 的测试值。

黑盒闪烁和消失

仔细检查之前未显示的 AdControl 部分中的所有步骤。
处理 ErrorOccurred 事件，并使用传递到事件处理程序的消息确定是否发生了错误以及引发了何种错误。有关详细信息，请参阅 XAML/C# 演练中的错误处理。

此示例演示了 ErrorOccurred 事件处理程序。第一个代码段是 XAML UI 标记。
```
<UI:AdControl AdUnitId="{AdUnitID}"
              ApplicationId="{ApplicationID}"
              Width="728" Height="90"
              ErrorOccurred="adControl_ErrorOccurred" />
<TextBlock x:Name="TextBlock1" TextWrapping="Wrap" Width="500" Height="250" />
```
此示例演示了相应的 C# 代码。
```
private void adControl_ErrorOccurred(object sender,               
    Microsoft.Advertising.WinRT.UI.AdErrorEventArgs e)
{
    TextBlock1.Text = e.ErrorMessage;
}
```
导致黑盒的最常见错误是“无广告可用”。此错误意味着请求返回不了任何广告。
AdControl 行为正常。

默认情况下，AdControl 在它无法显示广告时会折叠。如果其他元素均是相同父元素的子元素，它们可能会移动以填充折叠 AdControl 的间距，并在下一次提出请求时展开。

广告不刷新

检查 IsAutoRefreshEnabled 属性。默认情况下，此可选属性设置为 True。在设置为 False 时，必须使用 Refresh 方法检索其他广告。

<UI:AdControl AdUnitId="{AdUnitID}"
              ApplicationId="{ApplicationID}"
              Width="728" Height="90"
              IsAutoRefreshEnabled="True" />

检查 Refresh 方法的调用。当使用自动刷新时，Refresh 无法用于检索其他广告。当使用手动刷新时，Refresh 应仅在最少 30 到 60 秒后调用，具体取决于设备的当前数据连接。

以下代码段显示了如何使用 Refresh 方法的示例。第一个代码段是 XAML UI 标记。
```
<UI:AdControl x:Name="adControl1"
              AdUnitId="{AdUnit_ID}"
              ApplicationId="{ApplicationID}"
              Width="728" Height="90"
              IsAutoRefreshEnabled="False" />
```
此代码片段显示了隐藏在 UI 标记后的 C# 代码的示例。
```
public RefreshAds()
{
    var timer = new DispatcherTimer() { Interval = TimeSpan.FromSeconds(60) };
    timer.Tick += (s, e) => adControl1.Refresh();
    timer.Start();
}
```
AdControl 行为正常。有时如果广告不刷新，相同的广告会连续出现多次。

C#

AdControl 不显示

确保在 Package.appxmanifest 中选择“Internet (客户端)”功能。

确保 AdControl 已实例化。如果 AdControl 未实例化，它将不可用。

using Microsoft.Advertising.WinRT.UI;

namespace AdControlExample
{
    public sealed partial class MainPage : Page
    {
        AdControl myAdControl;
        
        public MainPage()
        {
            this.InitializeComponent();
            
            myAdControl = new AdControl()
            {
                ApplicationId = "{ApplicationID}",
                AdUnitId = "{AdUnitID}",
                Height = 90,
                Width = 728
            };
        }
    }
}

检查应用程序 ID 和广告单元 ID。这些 ID 必须匹配在合作伙伴中心中获取的应用程序 ID 和广告单元 ID。有关详细信息，请参阅在应用中设置广告单元。
```
adControl = new AdControl();
adControl.ApplicationId = "{ApplicationID}";adControl.AdUnitId = "{AdUnitID}";
adControl.Height = 90;
adControl.Width = 728;
```

检查 Height 和 Width 参数。这些属性必须设置为横幅广告的受支持广告大小之一。

adControl = new AdControl();
adControl.ApplicationId = "{ApplicationID}";
adControl.AdUnitId = "{AdUnitID}";
adControl.Height = 90;adControl.Width = 728;

确保 AdControl 已添加到父元素。若要显示，AdControl 必须作为子控件添加到父控件（例如，StackPanel 或 Grid）。
```
ContentPanel.Children.Add(adControl);
```
检查 Margin 参数。 AdControl 必须在可视区域内。

检查 Visibility 属性。可选 Visibility 属性必须设置为 Visible。

adControl = new AdControl();
adControl.ApplicationId = "{ApplicationID}";
adControl.AdUnitId = "{AdUnitID}";
adControl.Height = 90;
adControl.Width = 728;
adControl.Visibility = System.Windows.Visibility.Visible;

查看 AdControl 的父元素。父元素必须处于活动状态并且可见。
ApplicationId 和 AdUnitId 的动态值不应在仿真器中测试。若要确保 AdControl 正常运行，请使用 ApplicationId 和 AdUnitId 的测试值。

黑盒闪烁和消失

仔细检查上述 AdControl 未显示部分中的所有步骤。

处理 ErrorOccurred 事件，并使用传递到事件处理程序的消息确定是否发生了错误以及引发了何种错误。有关详细信息，请参阅 XAML/C# 演练中的错误处理。

以下示例显示了实现错误调用所需的基本代码。此 XAML 代码定义用来显示错误消息的 TextBlock。

<TextBlock x:Name="TextBlock1" TextWrapping="Wrap" Width="500" Height="250" />

此 C# 代码检索错误消息，并将其显示在 TextBlock 中。

using Microsoft.Advertising.WinRT.UI;

namespace AdControlExample
{
    public partial class MainPage : Page
    {
        AdControl myAdControl;
        
        public MainPage()
        {
            this.InitializeComponent();
            
            myAdControl = new AdControl();
            myAdControl.ApplicationId = "{ApplicationID}";
            myAdControl.AdUnitId = "{AdUnitID}";
            myAdControl.Height = 90;
            myAdControl.Width = 728;
            
            myAdControl.ErrorOccurred += (s,e) =>
            {
                TextBlock1.Text = e.Error.Message;
            };
        }
    }
}

导致黑盒的最常见错误是“无广告可用”。此错误意味着请求返回不了任何广告。

AdControl 行为正常。有时如果广告不刷新，相同的广告会连续出现多次。

广告不刷新

检查 AdControl 的 IsAutoRefreshEnabled 属性是否设置为 false。默认情况下，此可选属性设置为 true。在设置为 false 时，必须使用 Refresh 方法检索其他广告。

检查 Refresh 方法的调用。使用自动刷新（IsAutoRefreshEnabled 为 true）时，不能将 Refresh 用于检索其他广告。使用手动刷新（IsAutoRefreshEnabled 为 false）时，根据设备的当前数据连接，只应至少在 30 到 60 秒后调用Refresh。

以下示例展示了如何调用 Refresh 方法。

AdControl myAdControl;

public MainPage()
{
    InitializeComponent();

    myAdControl = new AdControl();
    myAdControl.ApplicationId = "{ApplicationID}";
    myAdControl.AdUnitId = "{AdUnitID}";
    myAdControl.Height = 90;
    myAdControl.Width = 728;
    myAdControl.IsAutoRefreshEnabled = false;

    ContentPanel.Children.Add(myAdControl);

    var timer = new DispatcherTimer() { Interval = TimeSpan.FromSeconds(60) };
    timer.Tick += (s, e) => myAdControl.Refresh();
    timer.Start();
}

AdControl 行为正常。有时如果广告不刷新，相同的广告会连续出现多次。

通过

XAML 和 C# 疑难解答指南

XAML

AdControl 不显示

黑盒闪烁和消失

广告不刷新

C#

AdControl 不显示

黑盒闪烁和消失

广告不刷新

反馈

反馈

其他资源