TileUpdater.StartPeriodicUpdateBatch Метод

  • Ссылка

Определение

Пространство имен:
Windows.UI.Notifications

Перегрузки

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

IIterable<Uri>

IEnumerable<Uri>

Массив до пяти универсальных кодов ресурса (URI), из которого будет извлекаться XML-содержимое обновлений плитки цикла. Если массив содержит более пяти универсальных кодов ресурса (URI), метод завершится ошибкой.

requestedInterval
PeriodicUpdateRecurrence

Частота опроса универсального кода ресурса (URI) на наличие нового содержимого плитки после первоначального обновления в startTime.

Атрибуты
OverloadAttribute

Комментарии

Использование очереди уведомлений с периодическими обновлениями

Чтобы использовать очередь уведомлений, необходимо сначала включить ее для плитки с помощью следующей строки кода:

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

Этот API необходимо вызывать только один раз в течение всего времени существования приложения, но при каждом запуске приложения вызов не повредит.

В случае периодических уведомлений для каждого уведомления предоставляется уникальный URL-адрес. Каждый URL-адрес периодически опрашиваться Windows на наличие обновленного содержимого уведомления. Полезные данные содержимого, возвращаемые с каждого URL-адреса, должны содержать версии XML-кода уведомления для всех поддерживаемых размеров плиток. Каждый опрошенный URL-адрес также может при необходимости возвращать собственное уникальное время окончания срока действия и значение тега.

Добавление тегов к уведомлениям о периодических обновлениях

Если очередь уведомлений включена, плитка может перебирать не более пяти уведомлений в очереди. Как правило, самое старое уведомление заменяется в очереди при поступлении нового уведомления. Однако уведомлениям можно предоставить тег , чтобы новое уведомление с определенным тегом заменяло старое уведомление тем же тегом, независимо от его места в очереди.

Теги — это необязательные строки длиной до 16 символов, которые можно задать в уведомлении в качестве идентификатора. Если новое уведомление поступает с тем же тегом, что и уведомление, уже вложенное в очередь, новое уведомление заменяет старое, а не попадает под поведение очереди первого входа, первого выхода по умолчанию. Это предотвратит ситуацию, когда в очереди одновременно присутствуют две версии одного и того же уведомления, одна из которых устарела.

В случае периодических уведомлений теги предоставляются в заголовке X-WNS-Tag http-ответа уведомления, которое также содержит содержимое уведомления. Это сообщение отправляется в ответ на периодический вызов системы к универсальному коду ресурса (URI) уведомления. Имя заголовка и значение тега не учитывают регистр.

Пример показан далее:

X-WNS-Tag: stockMSFT

Установка срока действия периодических обновлений

Срок действия периодических уведомлений по умолчанию истекает через три дня. Если срок действия содержимого уведомления значительно отличается ( короче или дольше), следует явно задать время окончания срока действия для каждого уведомления. Это предотвращает сохранение устаревшего или нерелевантного содержимого в очереди. Это особенно важно, если компьютер пользователя теряет подключение к Интернету в течение длительного периода времени.

Например, во время активной торговли рекомендуется установить срок действия уведомления о ценах акций в два раза больше, чем интервал опроса, например уведомление, которое истекает через час после отправки, если вы опрашиваете обновление каждые полчаса. В случае с приложением новостей срок действия плитки, отображающей самые популярные ежедневные новости, будет уместным сроком на один день.

Для периодических уведомлений время окончания срока действия задается в заголовке X-WNS-Expires в ответном сообщении HTTP уведомления. Время окончания срока действия выражается в формате HTTP-даты, которая использует один из форматов, показанных в следующих примерах:

  • Вс, 06 Ноя 1994 08:49:37 GMT
  • Воскресенье, 06-Ноя-94 08:49:37 GMT
  • Вс Ноя 6 08:49:37 1994

Дополнительные сведения о формате даты HTTP см. в документе Параметры протокола консорциума W3C 3.

Пример полной реализации периодических уведомлений, используемых в сочетании с очередью уведомлений, см. в разделе Сценарий 3 примера push-уведомлений и периодических уведомлений (архивные).

См. также раздел

Применяется к

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

IIterable<Uri>

IEnumerable<Uri>

Массив до пяти универсальных кодов ресурса (URI), из которого будет извлекаться XML-содержимое обновлений плитки цикла. Если массив содержит более пяти универсальных кодов ресурса (URI), метод завершится ошибкой.

startTime
DateTime DateTimeOffset

Время, когда исходный универсальный код ресурса (URI) должен быть сначала опрашиваться на наличие нового содержимого.

requestedInterval
PeriodicUpdateRecurrence

Частота опроса универсального кода ресурса (URI) на наличие нового содержимого плитки после первоначального обновления в startTime.

Атрибуты
OverloadAttribute

Комментарии

Использование очереди уведомлений с периодическими обновлениями

Чтобы использовать очередь уведомлений, необходимо сначала включить ее для плитки с помощью следующей строки кода:

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

Этот API необходимо вызывать только один раз в течение всего времени существования приложения, но при каждом запуске приложения вызов не повредит.

В случае периодических уведомлений для каждого уведомления предоставляется уникальный URL-адрес. Каждый URL-адрес периодически опрашиваться Windows на наличие обновленного содержимого уведомления. Полезные данные содержимого, возвращаемые с каждого URL-адреса, должны содержать версии XML-кода уведомления для всех поддерживаемых размеров плиток. Каждый опрошенный URL-адрес также может при необходимости возвращать собственное уникальное время окончания срока действия и значение тега.

Добавление тегов к уведомлениям о периодических обновлениях

Если очередь уведомлений включена, плитка может перебирать не более пяти уведомлений в очереди. Как правило, самое старое уведомление заменяется в очереди при поступлении нового уведомления. Однако уведомлениям можно предоставить тег , чтобы новое уведомление с определенным тегом заменяло старое уведомление тем же тегом, независимо от его места в очереди.

Теги — это необязательные строки длиной до 16 символов, которые можно задать в уведомлении в качестве идентификатора. Если новое уведомление поступает с тем же тегом, что и уведомление, уже вложенное в очередь, новое уведомление заменяет старое, а не попадает под поведение очереди первого входа, первого выхода по умолчанию. Это предотвратит ситуацию, когда в очереди одновременно присутствуют две версии одного и того же уведомления, одна из которых устарела.

В случае периодических уведомлений теги предоставляются в заголовке X-WNS-Tag http-ответа уведомления, которое также содержит содержимое уведомления. Это сообщение отправляется в ответ на периодический вызов системы к универсальному коду ресурса (URI) уведомления. Имя заголовка и значение тега не учитывают регистр.

Пример показан далее:

X-WNS-Tag: stockMSFT

Установка срока действия периодических обновлений

Срок действия плиток по умолчанию истекает через три дня. Если срок действия содержимого уведомления значительно отличается ( короче или дольше), следует явно задать время окончания срока действия для каждого уведомления. Это предотвращает сохранение устаревшего или нерелевантного содержимого в очереди. Это особенно важно, если компьютер пользователя теряет подключение к Интернету в течение длительного периода времени.

Например, во время активной торговли рекомендуется установить срок действия уведомления о ценах акций в два раза больше, чем интервал опроса, например уведомление, которое истекает через час после отправки, если вы опрашиваете обновление каждые полчаса. В случае с приложением новостей срок действия плитки, отображающей самые популярные ежедневные новости, будет уместным сроком на один день.

Для периодических уведомлений время окончания срока действия задается в заголовке X-WNS-Expires в ответном сообщении HTTP уведомления. Время окончания срока действия выражается в формате HTTP-даты, которая использует один из форматов, показанных в следующих примерах:

  • Вс, 06 Ноя 1994 08:49:37 GMT
  • Воскресенье, 06-Ноя-94 08:49:37 GMT
  • Вс Ноя 6 08:49:37 1994

Дополнительные сведения о формате даты HTTP см. в документе Параметры протокола консорциума W3C 3.

Пример полной реализации периодических уведомлений, используемых в сочетании с очередью уведомлений, см. в разделе Сценарий 3 примера push-уведомлений и периодических уведомлений (архивные).

См. также раздел

Применяется к