Partager via

TileUpdater.StartPeriodicUpdateBatch Méthode

  • Référence

Définition

Espace de noms:
Windows.UI.Notifications

Surcharges

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)

Commence une série de mises à jour chronologiques qui se mettent à jour sur la vignette à laquelle le programme de mise à jour est lié. Le contenu de la mise à jour est récupéré à partir d’un tableau d’URI (Uniform Resource Identifier) spécifié, la première mise à jour se produit immédiatement et les mises à jour suivantes se produisent à intervalles réguliers par la suite.

Notes

Pour utiliser cette fonctionnalité, vous devez d’abord activer la file d’attente de notification de la vignette en appelant EnableNotificationQueue.
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)

Commence une série de mises à jour chronologiques qui se mettent à jour sur la vignette à laquelle le programme de mise à jour est lié. Le contenu de la mise à jour est récupéré à partir d’un tableau d’URI (Uniform Resource Identifier) spécifié, les mises à jour commençant à une heure spécifiée et les mises à jour suivantes se produisant à intervalles réguliers par la suite.

Notes

Pour utiliser cette fonctionnalité, vous devez d’abord activer la file d’attente de notification de la vignette en appelant EnableNotificationQueue.

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)

Modifier

Commence une série de mises à jour chronologiques qui se mettent à jour sur la vignette à laquelle le programme de mise à jour est lié. Le contenu de la mise à jour est récupéré à partir d’un tableau d’URI (Uniform Resource Identifier) spécifié, la première mise à jour se produit immédiatement et les mises à jour suivantes se produisent à intervalles réguliers par la suite.

Notes

Pour utiliser cette fonctionnalité, vous devez d’abord activer la file d’attente de notification de la vignette en appelant 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)

Paramètres

tileContents

IIterable<Uri>

IEnumerable<Uri>

Tableau comprenant jusqu’à cinq URI (Uniform Resource Identifier) à partir duquel le contenu XML des mises à jour de vignettes de cycle sera récupéré. Si le tableau contient plus de cinq URI (Uniform Resource Identifier), la méthode échoue.

requestedInterval
PeriodicUpdateRecurrence

Fréquence à laquelle l’URI (Uniform Resource Identifier) est interrogé pour le nouveau contenu de vignette, après la mise à jour initiale à startTime.

Attributs
OverloadAttribute

Remarques

Utilisation de la file d’attente de notifications avec des mises à jour périodiques

Pour utiliser la file d’attente de notifications, vous devez d’abord l’activer pour votre vignette avec cette ligne de code :

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

Cette API ne doit être appelée qu’une seule fois dans la durée de vie de votre application, mais il n’y a aucun mal à l’appeler chaque fois que l’application est lancée.

Dans le cas de notifications périodiques, une URL unique est fournie pour chaque notification. Chaque URL est interrogée régulièrement par Windows pour rechercher le contenu de notification mis à jour. La charge utile de contenu retournée par chaque URL doit contenir des versions du xml de notification pour toutes les tailles de vignette prises en charge. Chaque URL interrogée peut également retourner sa propre heure d’expiration et sa propre valeur d’étiquette.

Notifications d’étiquetage pour les mises à jour périodiques

Une fois la file d’attente de notifications activée, votre vignette peut parcourir un maximum de cinq notifications en file d’attente. En règle générale, la notification la plus ancienne est remplacée dans la file d’attente lorsqu’une nouvelle notification arrive. Toutefois, les notifications peuvent recevoir une balise afin qu’une nouvelle notification avec une balise spécifique remplace une notification plus ancienne par la même balise, quelle que soit sa place dans la file d’attente.

Les balises sont des chaînes facultatives de 16 caractères pouvant être définies sur une notification en tant qu’identificateur. Si une nouvelle notification arrive avec la même balise qu’une notification déjà dans la file d’attente, la nouvelle notification remplace l’ancienne au lieu de tomber sous le comportement de file d’attente premier entrant, premier sorti par défaut. Cela empêche le cas où deux versions de la même notification , l’une d’entre elles obsolètes, sont présentes dans la file d’attente en même temps.

Dans le cas de notifications périodiques, des balises sont fournies dans l’en-tête X-WNS-Tag du message de réponse HTTP de la notification, qui inclut également le contenu de la notification. Ce message est envoyé en réponse à l’appel périodique du système à l’URI (Uniform Resource Identifier) de la notification. Le nom de l’en-tête et la valeur de balise ne respectent pas la casse.

En voici un exemple :

X-WNS-Tag: stockMSFT

Définition d’un délai d’expiration pour les mises à jour périodiques

Les notifications périodiques expirent par défaut au bout de trois jours. Si votre contenu de notification a une durée de vie utile sensiblement différente ( plus courte ou plus longue), vous devez définir explicitement un délai d’expiration pour chaque notification. Cela empêche le contenu obsolète ou non pertinent de rester dans la file d’attente. Cela est particulièrement important si l’ordinateur de l’utilisateur perd la connectivité Internet pendant une longue période.

Par exemple, pendant les transactions actives, il est recommandé pour une application boursière de définir l’expiration d’une notification de cours d’action sur le double de celle de votre intervalle d’interrogation, par exemple une notification qui expire une heure après son envoi si vous interrogez pour obtenir une mise à jour toutes les demi-heures. Dans le cas d’une application d’actualités, une expiration d’un jour pour une vignette affichant les principales actualités quotidiennes serait appropriée.

Pour les notifications périodiques, le délai d’expiration est défini dans l’en-tête X-WNS-Expires du message de réponse HTTP de la notification. L’heure d’expiration est exprimée sous la forme d’une date HTTP, qui utilise l’un des formats présentés dans ces exemples :

  • Dim, 06 nov 1994 08:49:37 GMT
  • Dimanche, 06-Nov-94 08:49:37 GMT
  • Dim Nov 6 08:49:37 1994

Pour plus d’informations sur le format http-date, consultez le document Paramètres du protocole W3C (World Wide Web Consortium) 3.

Pour obtenir un exemple d’implémentation complète des notifications périodiques utilisées conjointement avec la file d’attente de notifications, consultez Scénario 3 dans l’exemple Push et notifications périodiques (archivé).

Voir aussi

S’applique à

StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)

Modifier

Commence une série de mises à jour chrono timelées qui s’exécutent sur la vignette à laquelle le programme de mise à jour est lié. Le contenu de la mise à jour est récupéré à partir d’un tableau d’URI (Uniform Resource Identifier) spécifié, les mises à jour commençant à une heure spécifiée et les mises à jour suivantes se produisant à l’intervalle périodique suivant.

Notes

Pour utiliser cette fonctionnalité, vous devez d’abord activer la file d’attente de notification de la vignette en appelant 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)

Paramètres

tileContents

IIterable<Uri>

IEnumerable<Uri>

Tableau comprenant jusqu’à cinq URI (Uniform Resource Identifier) à partir duquel le contenu XML des mises à jour de vignettes de cycle sera récupéré. Si le tableau contient plus de cinq URI (Uniform Resource Identifier), la méthode échoue.

startTime
DateTime DateTimeOffset

Heure à laquelle l’URI (Uniform Resource Identifier) initial doit être interrogé pour la première fois pour rechercher le nouveau contenu.

requestedInterval
PeriodicUpdateRecurrence

Fréquence à laquelle l’URI (Uniform Resource Identifier) est interrogé pour le nouveau contenu de vignette, après la mise à jour initiale à startTime.

Attributs
OverloadAttribute

Remarques

Utilisation de la file d’attente de notifications avec des mises à jour périodiques

Pour utiliser la file d’attente de notifications, vous devez d’abord l’activer pour votre vignette avec cette ligne de code :

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

Cette API ne doit être appelée qu’une seule fois dans la durée de vie de votre application, mais il n’y a aucun mal à l’appeler chaque fois que l’application est lancée.

Dans le cas de notifications périodiques, une URL unique est fournie pour chaque notification. Chaque URL est interrogée régulièrement par Windows pour rechercher le contenu de notification mis à jour. La charge utile de contenu retournée par chaque URL doit contenir des versions du xml de notification pour toutes les tailles de vignette prises en charge. Chaque URL interrogée peut également retourner sa propre heure d’expiration et sa propre valeur d’étiquette.

Notifications d’étiquetage pour les mises à jour périodiques

Une fois la file d’attente de notifications activée, votre vignette peut parcourir un maximum de cinq notifications en file d’attente. En règle générale, la notification la plus ancienne est remplacée dans la file d’attente lorsqu’une nouvelle notification arrive. Toutefois, les notifications peuvent recevoir une balise afin qu’une nouvelle notification avec une balise spécifique remplace une notification plus ancienne par la même balise, quelle que soit sa place dans la file d’attente.

Les balises sont des chaînes facultatives de 16 caractères pouvant être définies sur une notification en tant qu’identificateur. Si une nouvelle notification arrive avec la même balise qu’une notification déjà dans la file d’attente, la nouvelle notification remplace l’ancienne au lieu de tomber sous le comportement de file d’attente premier entrant, premier sorti par défaut. Cela empêche le cas où deux versions de la même notification , l’une d’entre elles obsolètes, sont présentes dans la file d’attente en même temps.

Dans le cas de notifications périodiques, des balises sont fournies dans l’en-tête X-WNS-Tag du message de réponse HTTP de la notification, qui inclut également le contenu de la notification. Ce message est envoyé en réponse à l’appel périodique du système à l’URI (Uniform Resource Identifier) de la notification. Le nom de l’en-tête et la valeur de balise ne respectent pas la casse.

En voici un exemple :

X-WNS-Tag: stockMSFT

Définition d’un délai d’expiration pour les mises à jour périodiques

Les vignettes expirent par défaut au bout de trois jours. Si votre contenu de notification a une durée de vie utile sensiblement différente ( plus courte ou plus longue), vous devez définir explicitement un délai d’expiration pour chaque notification. Cela empêche le contenu obsolète ou non pertinent de rester dans la file d’attente. Cela est particulièrement important si l’ordinateur de l’utilisateur perd la connectivité Internet pendant une longue période.

Par exemple, pendant les transactions actives, il est recommandé pour une application boursière de définir l’expiration d’une notification de cours d’action sur le double de celle de votre intervalle d’interrogation, par exemple une notification qui expire une heure après son envoi si vous interrogez pour obtenir une mise à jour toutes les demi-heures. Dans le cas d’une application d’actualités, une expiration d’un jour pour une vignette affichant les principales actualités quotidiennes serait appropriée.

Pour les notifications périodiques, le délai d’expiration est défini dans l’en-tête X-WNS-Expires du message de réponse HTTP de la notification. L’heure d’expiration est exprimée sous la forme d’une date HTTP, qui utilise l’un des formats présentés dans ces exemples :

  • Dim, 06 nov 1994 08:49:37 GMT
  • Dimanche, 06-Nov-94 08:49:37 GMT
  • Dim Nov 6 08:49:37 1994

Pour plus d’informations sur le format http-date, consultez le document Paramètres du protocole W3C (World Wide Web Consortium) 3.

Pour obtenir un exemple d’implémentation complète des notifications périodiques utilisées conjointement avec la file d’attente de notifications, consultez Scénario 3 dans l’exemple Push et notifications périodiques (archivé).

Voir aussi

S’applique à