TileUpdater.StartPeriodicUpdateBatch 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence) |
开始在更新程序绑定到的磁贴上循环的一系列计时更新。 更新内容是从指定统一资源标识符的数组中检索的， (URI) ，第一次更新立即发生，后续更新随后定期发生。 注意 若要使用此功能，必须先通过调用 EnableNotificationQueue 来启用磁贴的通知队列。 |
| StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence) |
开始在更新程序绑定到的磁贴上循环的一系列计时更新。 更新内容是从指定统一资源标识符 (URI) 数组中检索的，更新从指定时间开始，随后定期更新。 注意 若要使用此功能，必须先通过调用 EnableNotificationQueue 来启用磁贴的通知队列。 |
StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
开始在更新程序绑定到的磁贴上循环的一系列计时更新。 更新内容是从指定统一资源标识符的数组中检索的， (URI) ，第一次更新立即发生，后续更新随后定期发生。
注意
若要使用此功能，必须先通过调用 EnableNotificationQueue 来启用磁贴的通知队列。
public:
virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, PeriodicUpdateRecurrence const& requestedInterval);[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, PeriodicUpdateRecurrence requestedInterval);function startPeriodicUpdateBatch(tileContents, requestedInterval)Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), requestedInterval As PeriodicUpdateRecurrence)参数
- tileContents
最多五个统一资源标识符的数组 (URI) ，将从中检索循环磁贴更新的 XML 内容。 如果数组包含五个以上的统一资源标识符 (URI) ，则 方法将失败。
- requestedInterval
- PeriodicUpdateRecurrence
在 startTime 进行初始更新后，统一资源标识符 (URI) 轮询新磁贴内容的频率。
- 属性
注解
将通知队列与定期更新配合使用
若要使用通知队列，必须先使用以下代码行为磁贴启用它：
Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);
此 API 在应用的生存期内只需调用一次，但每次应用启动时调用它没有任何危害。
对于定期通知，会为每个通知提供唯一的 URL。 Windows 定期轮询每个 URL 以获取更新的通知内容。 从每个 URL 返回的内容有效负载应包含所有受支持的磁贴大小的通知 XML 版本。 每个轮询的 URL 还可以选择返回其自己的唯一过期时间和标记值。
标记定期更新的通知
启用通知队列后，磁贴最多可以循环访问五个排队通知。 通常，当新通知到达时，队列中最早的通知将被替换。 但是，可以为通知提供标记，以便具有特定标记的新通知将旧通知替换为同一标记，而不考虑通知在队列中的位置。
标记是最多 16 个字符的可选字符串，可在通知上将其设置为标识符。 如果新通知的到达标记与队列中已有的通知相同，则新通知将替换旧通知，而不是处于默认的先入先出队列行为之下。 这可以防止队列中同时存在同一通知的两个版本（其中一个版本已过期）。
对于定期通知，标记在通知的 HTTP 响应消息的 X-WNS-Tag 标头中提供，其中还包括通知的内容。 发送此消息以响应系统定期调用通知的统一资源标识符 (URI) 。 标头名称和标记值不区分大小写。
下面显示了一个示例：
X-WNS-Tag: stockMSFT
设置定期更新的过期时间
默认情况下，定期通知会在三天后过期。 如果通知内容的有用期限明显不同（较短或更长），则应为每个通知显式设置过期时间。 这可以防止过时或不相关的内容留在队列中。 如果用户的计算机长时间失去 Internet 连接，这一点尤其重要。
例如，在活跃交易期间，建议股票应用将股票价格通知的到期时间设置为轮询间隔的两倍，例如，如果你每半小时轮询更新一次，通知在发送一小时后过期。 对于新闻应用，对于显示每日热门新闻的磁贴，应为一天的过期时间。
对于定期通知，过期时间在通知的 HTTP 响应消息的 X-WNS-Expires 标头中设置。 过期时间表示为 HTTP 日期，它使用以下示例中所示的格式之一：
- 星期日， 1994 年 11 月 6 日 08：49：37 GMT
- 周日，06-11月94日 08：49：37 GMT
- 星期日 11 月 6 日 08：49：37 1994
有关 HTTP 日期格式的详细信息，请参阅万维网联盟 (W3C) 3 协议参数 文档。
有关与通知队列一起使用的定期通知的完整实现示例，请参阅 推送和定期通知示例 (存档) 中的方案 3。
另请参阅
- StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
- StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
- 如何为磁贴设置定期通知
- 定期通知的指南和清单
- 磁贴和磁贴通知概述
适用于
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
开始在更新程序绑定到的磁贴上循环的一系列计时更新。 更新内容是从指定的统一资源标识符数组 (URI) 检索的，更新从指定时间开始，然后定期间隔进行后续更新。
注意
若要使用此功能，必须先通过调用 EnableNotificationQueue 来启用磁贴的通知队列。
public:
virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, DateTime startTime, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, DateTime const& startTime, PeriodicUpdateRecurrence const& requestedInterval);[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, System.DateTimeOffset startTime, PeriodicUpdateRecurrence requestedInterval);function startPeriodicUpdateBatch(tileContents, startTime, requestedInterval)Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), startTime As DateTimeOffset, requestedInterval As PeriodicUpdateRecurrence)参数
- tileContents
最多五个统一资源标识符的数组 (URI) ，将从中检索循环磁贴更新的 XML 内容。 如果数组包含五个以上的统一资源标识符 (URI) ，则 方法将失败。
- startTime
- DateTime DateTimeOffset
应首先轮询初始统一资源标识符 (URI) 以获取新内容的时间。
- requestedInterval
- PeriodicUpdateRecurrence
在 startTime 进行初始更新后，统一资源标识符 (URI) 轮询新磁贴内容的频率。
- 属性
注解
将通知队列与定期更新配合使用
若要使用通知队列，必须先使用以下代码行为磁贴启用它：
Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);
此 API 在应用的生存期内只需调用一次，但每次应用启动时调用它没有任何危害。
对于定期通知，会为每个通知提供唯一的 URL。 Windows 定期轮询每个 URL 以获取更新的通知内容。 从每个 URL 返回的内容有效负载应包含所有受支持的磁贴大小的通知 XML 版本。 每个轮询的 URL 还可以选择返回其自己的唯一过期时间和标记值。
标记定期更新的通知
启用通知队列后，磁贴最多可以循环访问五个排队通知。 通常，当新通知到达时，队列中最早的通知将被替换。 但是，可以为通知提供标记，以便具有特定标记的新通知将旧通知替换为同一标记，而不考虑通知在队列中的位置。
标记是最多 16 个字符的可选字符串，可在通知上将其设置为标识符。 如果新通知的到达标记与队列中已有的通知相同，则新通知将替换旧通知，而不是处于默认的先入先出队列行为之下。 这可以防止队列中同时存在同一通知的两个版本（其中一个版本已过期）。
对于定期通知，标记在通知的 HTTP 响应消息的 X-WNS-Tag 标头中提供，其中还包括通知的内容。 发送此消息以响应系统定期调用通知的统一资源标识符 (URI) 。 标头名称和标记值不区分大小写。
下面显示了一个示例：
X-WNS-Tag: stockMSFT
设置定期更新的过期时间
默认情况下，磁贴会在三天后过期。 如果通知内容的有用期限明显不同（较短或更长），则应为每个通知显式设置过期时间。 这可以防止过时或不相关的内容留在队列中。 如果用户的计算机长时间失去 Internet 连接，这一点尤其重要。
例如，在活跃交易期间，建议股票应用将股票价格通知的到期时间设置为轮询间隔的两倍，例如，如果你每半小时轮询更新一次，通知在发送一小时后过期。 对于新闻应用，对于显示每日热门新闻的磁贴，应为一天的过期时间。
对于定期通知，过期时间在通知的 HTTP 响应消息的 X-WNS-Expires 标头中设置。 过期时间表示为 HTTP 日期，它使用以下示例中所示的格式之一：
- 星期日， 1994 年 11 月 6 日 08：49：37 GMT
- 周日，06-11月94日 08：49：37 GMT
- 星期日 11 月 6 日 08：49：37 1994
有关 HTTP 日期格式的详细信息，请参阅万维网联盟 (W3C) 3 协议参数 文档。
有关与通知队列一起使用的定期通知的完整实现示例，请参阅 推送和定期通知示例 (存档) 中的方案 3。
另请参阅
- StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
- StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
- 如何为磁贴设置定期通知
- 定期通知的指南和清单
- 磁贴和磁贴通知概述
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈