背水一战 Windows 10 (112) - 通知（Badge）: application 的 badge 通知, secondary 的 badge 通知, 轮询服务端以更新 badge 通知(代

【背水一战 Windows 10 (112) - 通知（Badge）: application 的 badge 通知, secondary 的 badge 通知, 轮询服务端以更新 badge 通知(代】博观而约取，厚积而薄发。这篇文章主要讲述背水一战 Windows 10 (112) - 通知（Badge）: application 的 badge 通知, secondary 的 badge 通知, 轮询服务端以更新 badge 通知(代相关的知识，希望能为你提供帮助。
背水一战 Windows 10 之通知（Badge）: application 的 badge 通知, secondary 的 badge 通知, 轮询服务端以更新 badge 通知[源码下载]

背水一战 Windows 10 (112) - 通知（Badge）: application 的 badge 通知, secondary 的 badge 通知, 轮询服务端以更新 badge 通知

作者：webabcd

介绍
背水一战 Windows 10 之通知（Badge）

application 的 badge 通知
secondary 的 badge 通知
轮询服务端以更新 badge 通知

示例
1、本例用于演示 application 的 badge 通知
Notification/Badge/ApplicationBadge.xaml

< Page x:Class="Windows10.Notification.Badge.ApplicationBadge" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:local="using:Windows10.Notification.Badge" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="d"> < Grid Background="Transparent"> < StackPanel Margin="10 0 10 10"> < Button Name="btnUpdateBadgeWidthNumber" Content="以数字的方式更新 Application Badge" Click="btnUpdateBadgeWidthNumber_Click" Margin="5" /> < StackPanel Orientation="Horizontal" Margin="5"> < ComboBox Name="cmbBadgeValue"> < ComboBoxItem Content="activity" IsSelected="True" /> < ComboBoxItem Content="alarm" /> < ComboBoxItem Content="alert" /> < ComboBoxItem Content="attention" /> < ComboBoxItem Content="available" /> < ComboBoxItem Content="away" /> < ComboBoxItem Content="busy" /> < ComboBoxItem Content="error" /> < ComboBoxItem Content="newMessage" /> < ComboBoxItem Content="paused" /> < ComboBoxItem Content="playing" /> < ComboBoxItem Content="unavailable" /> < /ComboBox> < Button Name="btnUpdateBadgeWidthIcon" Content="以图标的方式更新 Application Badge" Click="btnUpdateBadgeWidthIcon_Click" Margin="5 0 0 0" /> < /StackPanel> < Button Name="btnClearBadge" Content="清除 Application Badge" Click="btnClearBadge_Click" Margin="5" /> < /StackPanel> < /Grid> < /Page>

Notification/Badge/ApplicationBadge.xaml.cs

/* * 本例用于演示 application 的 badge 通知 *application 的 badge 通知会显示在 application tile 上和 app 的任务栏的图标上 * * BadgeNotification - Badge 通知 *Content - Badge 的内容，XmlDocument 类型的数据，只读，其需要在构造函数中指定 *ExpirationTime - Badge 通知的过期时间，超过这个时间就会清除这个 Badge（application tile 的 badge 会被清除，而 app 的任务栏的图标上的 badge 不会被清除） * * BadgeUpdateManager - Badge 更新管理器 *CreateBadgeUpdaterForApplication() - 创建一个 Application 的 Badge 更新器，返回 BadgeUpdater 类型的数据 * * BadgeUpdater - Badge 更新器 *Update() - 更新指定的 BadgeNotification *Clear() - 清除 BadgeNotification * * * 注：本例是通过 xml 来构造 badge 的，另外也可以通过 NuGet 的 Microsoft.Toolkit.Uwp.Notifications 来构造 badge（其用 c# 对 xml 做了封装） */using System; using Windows.Data.Xml.Dom; using Windows.UI.Notifications; using Windows.UI.Xaml; using Windows.UI.Xaml.Controls; namespace Windows10.Notification.Badge { public sealed partial class ApplicationBadge : Page { public ApplicationBadge() { this.InitializeComponent(); }// 以数字的方式更新 Application Badge 通知 private void btnUpdateBadgeWidthNumber_Click(object sender, RoutedEventArgs e) { // 用于描述 badge 通知的 xml 字符串（数字在 1 - 99 之间，如果大于 99 则会显示 99+ ，如果是 0 则会移除 badge，如果小于 0 则无效） string badgeXml = "< badge value=https://www.songbingjia.com/'6\'/> "; // 将 xml 字符串转换为 Windows.Data.Xml.Dom.XmlDocument 对象 XmlDocument badgeDoc = new XmlDocument(); badgeDoc.LoadXml(badgeXml); // 获取此 badge 的 xml // lblMsg.Text = badgeXml.GetXml(); // 实例化 BadgeNotification 对象 BadgeNotification badgeNotification = new BadgeNotification(badgeDoc); DateTimeOffset expirationTime = DateTimeOffset.UtcNow.AddSeconds(30); badgeNotification.ExpirationTime = expirationTime; // 30 秒后清除这个 badge// 将指定的 BadgeNotification 对象更新到 application BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForApplication(); badgeUpdater.Update(badgeNotification); }// 以图标的方式更新 Application Badge 通知 private void btnUpdateBadgeWidthIcon_Click(object sender, RoutedEventArgs e) { // 用于描述 badge 通知的 xml 字符串 string badgeXml = $"< badge value=https://www.songbingjia.com/'{((ComboBoxItem)cmbBadgeValue.SelectedItem).Content}\'/> "; // 将 xml 字符串转换为 Windows.Data.Xml.Dom.XmlDocument 对象 XmlDocument badgeDoc = new XmlDocument(); badgeDoc.LoadXml(badgeXml); // 获取此 badge 的 xml // lblMsg.Text = badgeXml.GetXml(); // 实例化 BadgeNotification 对象 BadgeNotification badgeNotification = new BadgeNotification(badgeDoc); DateTimeOffset expirationTime = DateTimeOffset.UtcNow.AddSeconds(30); badgeNotification.ExpirationTime = expirationTime; // 30 秒后清除这个 badge// 将指定的 BadgeNotification 对象更新到 application BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForApplication(); badgeUpdater.Update(badgeNotification); }// 清除 Application Badge 通知 private void btnClearBadge_Click(object sender, RoutedEventArgs e) { BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForApplication(); badgeUpdater.Clear(); } } }

2、本例用于演示 secondary tile 的 badge 通知
Notification/Badge/SecondaryTileBadge.xaml

< Page x:Class="Windows10.Notification.Badge.SecondaryTileBadge" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:local="using:Windows10.Notification.Badge" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="d"> < Grid Background="Transparent"> < StackPanel Margin="10 0 10 10"> < TextBlock Name="lblMsg" Margin="5" /> < Button Name="btnUpdateBadgeWidthNumber" Content="以数字的方式更新指定的 Secondary Tile 的 Badge" Click="btnUpdateBadgeWidthNumber_Click" Margin="5" /> < StackPanel Orientation="Horizontal" Margin="5"> < ComboBox Name="cmbBadgeValue"> < ComboBoxItem Content="activity" IsSelected="True" /> < ComboBoxItem Content="alarm" /> < ComboBoxItem Content="alert" /> < ComboBoxItem Content="attention" /> < ComboBoxItem Content="available" /> < ComboBoxItem Content="away" /> < ComboBoxItem Content="busy" /> < ComboBoxItem Content="error" /> < ComboBoxItem Content="newMessage" /> < ComboBoxItem Content="paused" /> < ComboBoxItem Content="playing" /> < ComboBoxItem Content="unavailable" /> < /ComboBox> < Button Name="btnUpdateBadgeWidthIcon" Content="以图标的方式更新指定的 Secondary Tile 的 Badge" Click="btnUpdateBadgeWidthIcon_Click" Margin="5 0 0 0" /> < /StackPanel> < Button Name="btnClearBadge" Content="清除指定的 Secondary Tile 的 Badge" Click="btnClearBadge_Click" Margin="5" /> < /StackPanel> < /Grid> < /Page>

Notification/Badge/SecondaryTileBadge.xaml.cs

/* * 本例用于演示 secondary tile 的 badge 通知 *secondary tile 的 badge 通知会显示在 secondary tile 上和 app 的任务栏的图标上 * * BadgeNotification - Badge 通知 *Content - Badge 的内容，XmlDocument 类型的数据，只读，其需要在构造函数中指定 *ExpirationTime - Badge 通知的过期时间，超过这个时间就会清除这个 Badge * * BadgeUpdateManager - Badge 更新管理器 *CreateBadgeUpdaterForSecondaryTile(string tileId) - 为指定的 secondary tile 创建一个 Badge 更新器，返回 BadgeUpdater 类型的数据 * * BadgeUpdater - Badge 更新器 *Update() - 更新指定的 BadgeNotification *Clear() - 清除 BadgeNotification * * * 注：本例是通过 xml 来构造 badge 的，另外也可以通过 NuGet 的 Microsoft.Toolkit.Uwp.Notifications 来构造 badge（其用 c# 对 xml 做了封装） */using System; using Windows.Data.Xml.Dom; using Windows.UI.Notifications; using Windows.UI.StartScreen; using Windows.UI.Xaml; using Windows.UI.Xaml.Controls; using Windows.UI.Xaml.Navigation; namespace Windows10.Notification.Badge { public sealed partial class SecondaryTileBadge : Page { private const string TILEID = "tile_badge"; public SecondaryTileBadge() { this.InitializeComponent(); }// 在开始屏幕固定一个 secondary tile 磁贴 protected async override void OnNavigatedTo(NavigationEventArgs e) { base.OnNavigatedTo(e); Uri square150x150Logo = new Uri("ms-appx:///Assets/Square150x150Logo.png"); Uri wide310x150Logo = new Uri("ms-appx:///Assets/Wide310x150Logo.png"); Uri square310x310Logo = new Uri("ms-appx:///Assets/Square310x310Logo.png"); SecondaryTile secondaryTile = new SecondaryTile(TILEID, "name", "arguments", square150x150Logo, TileSize.Wide310x150); secondaryTile.VisualElements.Wide310x150Logo = wide310x150Logo; secondaryTile.VisualElements.Square310x310Logo = square310x310Logo; try { bool isPinned = await secondaryTile.RequestCreateAsync(); lblMsg.Text = isPinned ? "固定成功" : "固定失败"; } catch (Exception ex) { lblMsg.Text = "固定失败: " + ex.ToString(); } }// 以数字的方式更新指定的 Secondary Tile 的 Badge 通知 private void btnUpdateBadgeWidthNumber_Click(object sender, RoutedEventArgs e) { // 用于描述 badge 通知的 xml 字符串（数字在 1 - 99 之间，如果大于 99 则会显示 99+ ，如果是 0 则会移除 badge，如果小于 0 则无效） string badgeXml = "< badge value=https://www.songbingjia.com/'6\'/> "; // 将 xml 字符串转换为 Windows.Data.Xml.Dom.XmlDocument 对象 XmlDocument badgeDoc = new XmlDocument(); badgeDoc.LoadXml(badgeXml); // 获取此 badge 的 xml // lblMsg.Text = badgeXml.GetXml(); // 实例化 BadgeNotification 对象 BadgeNotification badgeNotification = new BadgeNotification(badgeDoc); DateTimeOffset expirationTime = DateTimeOffset.UtcNow.AddSeconds(30); badgeNotification.ExpirationTime = expirationTime; // 30 秒后清除这个 badge// 将指定的 BadgeNotification 对象更新到指定的 secondary tile 磁贴 BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile(TILEID); badgeUpdater.Update(badgeNotification); }// 以图标的方式更新指定的 Secondary Tile 的 Badge 通知 private void btnUpdateBadgeWidthIcon_Click(object sender, RoutedEventArgs e) { // 用于描述 badge 通知的 xml 字符串 string badgeXml = $"< badge value=https://www.songbingjia.com/'{((ComboBoxItem)cmbBadgeValue.SelectedItem).Content}\'/> "; // 将 xml 字符串转换为 Windows.Data.Xml.Dom.XmlDocument 对象 XmlDocument badgeDoc = new XmlDocument(); badgeDoc.LoadXml(badgeXml); // 获取此 badge 的 xml // lblMsg.Text = badgeXml.GetXml(); // 实例化 BadgeNotification 对象 BadgeNotification badgeNotification = new BadgeNotification(badgeDoc); DateTimeOffset expirationTime = DateTimeOffset.UtcNow.AddSeconds(30); badgeNotification.ExpirationTime = expirationTime; // 30 秒后清除这个 badge// 将指定的 BadgeNotification 对象更新到指定的 secondary tile 磁贴 BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile(TILEID); badgeUpdater.Update(badgeNotification); }// 清除指定的 Secondary Tile 的 Badge 通知 private void btnClearBadge_Click(object sender, RoutedEventArgs e) { BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile(TILEID); badgeUpdater.Clear(); } } }

3、演示如何轮询服务端以更新 badge 通知
Notification/Badge/Periodic.xaml

< Page x:Class="Windows10.Notification.Badge.Periodic" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:local="using:Windows10.Notification.Badge" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="d"> < Grid Background="Transparent"> < StackPanel Margin="10 0 10 10"> < TextBlock Name="lblMsg" Margin="5" /> < Button Name="btnStartPeriodicUpdate" Content="启动一个“轮询服务端以更新 badge 通知”的任务" Click="btnStartPeriodicUpdate_Click" Margin="5" /> < /StackPanel> < /Grid> < /Page>

Notification/Badge/Periodic.xaml.cs

/* * 演示如何轮询服务端以更新 badge 通知 * * BadgeUpdater - Badge 更新器 *StartPeriodicUpdate(Uri badgeContent, PeriodicUpdateRecurrence requestedInterval) - 启动一个“轮询服务端以更新 badge 通知”的任务 *StartPeriodicUpdate(Uri badgeContent, DateTimeOffset startTime, PeriodicUpdateRecurrence requestedInterval) - 启动一个“轮询服务端以更新 badge 通知”的任务 *badgeContent - Badge 通知的内容（xml 格式数据）的 uri 地址（指定多个则会循环显示） *startTime - 可以指定启动此任务的时间 *指定此值时的逻辑为：首先会立刻请求服务端获取数据，然后在到达 startTime 指定的时间点后再次获取数据，最后再每次按 requestedInterval 指定的间隔轮询服务端 *requestedInterval - 轮询服务端的周期（PeriodicUpdateRecurrence 枚举） *HalfHour, Hour, SixHours, TwelveHours, Daily *StopPeriodicUpdate() - 停止“轮询服务端以更新 badge 通知”的任务 * * * 注：服务端代码请参见 WebApi/Controllers/BadgeContentController.cs（有指定 X-WNS-Expires 标头和 X-WNS-Tag 标头的示例） */using System; using Windows.UI.Notifications; using Windows.UI.StartScreen; using Windows.UI.Xaml; using Windows.UI.Xaml.Controls; using Windows.UI.Xaml.Navigation; namespace Windows10.Notification.Badge { public sealed partial class Periodic : Page { private const string TILEID = "tile_badge_periodic"; public Periodic() { this.InitializeComponent(); }// 在开始屏幕固定一个 secondary tile 磁贴 protected async override void OnNavigatedTo(NavigationEventArgs e) { base.OnNavigatedTo(e); Uri square150x150Logo = new Uri("ms-appx:///Assets/Square150x150Logo.png"); Uri wide310x150Logo = new Uri("ms-appx:///Assets/Wide310x150Logo.png"); Uri square310x310Logo = new Uri("ms-appx:///Assets/Square310x310Logo.png"); SecondaryTile secondaryTile = new SecondaryTile(TILEID, "name", "arguments", square150x150Logo, TileSize.Wide310x150); secondaryTile.VisualElements.Wide310x150Logo = wide310x150Logo; secondaryTile.VisualElements.Square310x310Logo = square310x310Logo; try { bool isPinned = await secondaryTile.RequestCreateAsync(); lblMsg.Text = isPinned ? "固定成功" : "固定失败"; } catch (Exception ex) { lblMsg.Text = "固定失败: " + ex.ToString(); } }// 启动一个“轮询服务端以更新 badge 通知”的任务 private void btnStartPeriodicUpdate_Click(object sender, RoutedEventArgs e) { // 启动一个循环更新 Badge 通知的任务，并指定 Badge 通知的数据源和轮询周期 BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile(TILEID); // 马上请求服务端获取数据，然后 45 分钟之后再次获取数据，最后再每半个小时获取一次数据 badgeUpdater.StartPeriodicUpdate(new Uri("http://localhost:44914/api/BadgeContent", UriKind.Absolute), DateTimeOffset.UtcNow.AddMinutes(45), PeriodicUpdateRecurrence.HalfHour); // Badge 通知的数据源示例请参见 WebApi/Controllers/BadgeContentController.cs } } }

OK
[源码下载]