TileUpdater.StartPeriodicUpdateBatch | startPeriodicUpdateBatch Methods

Commence une série de mises à jour chronométrées sur la mosaïque à laquelle est lié le programme de mise à jour et récupère jusqu'à cinq notifications depuis un tableau de cinq URI (Uniform Resource Identifier) au maximum pour alimenter la file d'attente des notifications de la mosaïque.
Remarque  Pour utiliser cette fonctionnalité, vous devez d'abord activer la file d'attente de notification de la mosaïque en appelant EnableNotificationQueue.

Liste de surcharges

MéthodeDescription
StartPeriodicUpdateBatch(IIterable(Uri), PeriodicUpdateRecurrence) Begins a series of timed updates that cycle on the tile that the updater is bound to. Update content is retrieved from an array of specified Uniform Resource Identifier (URI), the first update happening immediately and subsequent updates occurring at the periodic interval thereafter.
StartPeriodicUpdateBatch(IIterable(Uri), DateTime, PeriodicUpdateRecurrence) Begins a series of timed updates that cycle on the tile that the updater is bound to. Update content is retrieved from an array of specified Uniform Resource Identifier (URI) with updates beginning at a specified time and subsequent updates occurring at the periodic interval thereafter.

Remarques

Utilisation de la file d'attente de notification avec les mises à jour périodiques

Pour utiliser la file d'attente de notification, vous devez d'abord l'activer pour votre mosaïque avec cette ligne de code :


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

Cette API n'a besoin d'être appelée qu'une fois au cours de la durée de vie de votre application, mais il n'y a aucun mal à l'appeler chaque fois que l'application démarre.

Dans le cas de notifications périodiques, une URL unique est fournie pour chaque notification. Chaque URL est interrogée sur une base périodique par Windows pour le contenu de notification mis à jour. La charge utile de contenu retournée par chaque URL doit contenir les versions larges et carrées du XML pour la notification. Chaque URL interrogée peut éventuellement retourner son propre délai d'expiration et sa propre valeur de balise.

Étiquetage des notifications pour les mises à jour périodiques

Avec la file d'attente de notification activée, votre mosaïque peut passer par un maximum de cinq notifications mises en file d'attente. En général, la notification la plus ancienne est remplacée dans la file d'attente lorsqu'une nouvelle notification arrive. Toutefois, une balise peut être attribuée aux notifications pour qu'une nouvelle notification avec une balise spécifique remplace une notification plus ancienne avec la même balise, indépendamment de sa position dans la file d'attente.

Les balises sont des chaînes facultatives contenant jusqu'à 16 caractères qui peuvent être définis sur une notification comme identificateur. Si une nouvelle notification arrive à la même balise qu'une notification déjà dans la file d'attente, la nouvelle notification remplace l'ancienne, au lieu d'utiliser le comportement de file d'attente par défaut premier entré premier sorti. Cela empêche le cas où deux versions de la même notification, dont l'une est périmée—, sont présentes en même temps dans la file d'attente—.

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

Un exemple est présenté ici :


X-WNS-Tag: stockMSFT

Définition d'une heure d'expiration pour les mises à jour périodiques

Les notifications périodiques expirent par défaut après trois jours. Si le contenu de votre notification a une durée de vie considérablement différente—plus courte ou plus longue—, vous pouvez définir explicitement un délai d'expiration pour chaque notification, et il est conseillé de le faire. Cela empêche le contenu périmé ou sans importance de rester dans la file d'attente. C'est particulièrement important si l'ordinateur de l'utilisateur perd la connectivité Internet pendant une longue période.

Par exemple, au cours d'une négociation active des titres, il serait bon qu'une application de cotation boursière définisse l'expiration du cours d'une action sur une valeur deux fois supérieure à celle de la fréquence d'interrogation, par exemple une notification qui expirerait une heure après avoir été envoyée si l'intervalle d'interrogation de mise à jour se produit chaque demi-heure. Dans le cas d'une application de nouvelles, une expiration d'un jour pour une mosaïque affichant les nouvelles quotidiennes les plus importantes 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. Le délai d'expiration est exprimé sous forme de date HTTP, qui utilise l'un des formats indiqués dans les exemples ci-après :

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

Pour plus d'informations sur le format de date HTTP, consultez le document sur le site du World Wide Web Consortium (W3C) Protocol Parameters.

Pour obtenir un exemple complet d'implémentation des notifications périodiques utilisées avec la file d'attente de notification, consultez le scénario 4 de l'Exemple de notifications de type push et périodiques.

Conditions requises

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Notifications
Windows::UI::Notifications [C++]

Métadonnées

Windows.winmd

Voir aussi

TileUpdater
StartPeriodicUpdate
Comment installer les notifications périodiques pour les mosaïques
Instructions et liste de contrôle pour les notifications périodiques
Vue d'ensemble de la mosaïque et de la notification de mosaïque

 

 

Afficher:
© 2014 Microsoft