StartPeriodicUpdateBatch(IIterable(Uri), PeriodicUpdateRecurrence) | startPeriodicUpdateBatch(IIterable(Uri), PeriodicUpdateRecurrence), méthode

TileUpdater.StartPeriodicUpdateBatch(IIterable(Uri), PeriodicUpdateRecurrence) | startPeriodicUpdateBatch(IIterable(Uri), PeriodicUpdateRecurrence) Method

Démarre une série de mises à jour planifiées auquel le cycle sur la mosaïque à laquelle le programme de mise à jour est lié. Le contenu des mises à jour est extrait du tableau des URI spécifiés. La première mise à jour débute immédiatement et les mises à jour suivantes sont effectuées à intervalle périodique.

Remarque  Pour utiliser cette fonctionnalité, vous devez d'abord activer la file d'attente de notification de la mosaïque en appelant EnableNotificationQueue.

Syntaxe


tileUpdater.startPeriodicUpdateBatch(tileContents, requestedInterval);

Paramètres

tileContents

Type: IIterable<Uri> [JavaScript/C++] | System.Collections.Generic.IEnumerable<Uri> [.NET]

Tableau de cinq URI au maximum d'où le contenu XML des mises à jour de mosaïque défilante sera récupéré. Si le tableau contient plus de cinq URI, la méthode échoue.

requestedInterval

Type: PeriodicUpdateRecurrence

Fréquence à laquelle l'URI est interrogé sur le nouveau contenu de la mosaïque, suite à la première mise à jour à startTime.

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 devez définir explicitement un délai d'expiration pour chaque notification. 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) 3 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 3 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
StartPeriodicUpdateBatch(IIterable(Uri), DateTime, PeriodicUpdateRecurrence)
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:
© 2017 Microsoft