Langage: HTML | XAML

Comment utiliser la file d’attente de notifications avec des notifications locales (applications Windows Runtime en C#/VB/C++ et XAML)

Applies to Windows and Windows Phone

Remarque  Vous n'utilisez pas C#/VB/C++ ? Voir Comment utiliser la file d’attente de notifications avec les notifications locales (applications du Windows Store en JavaScript et HTML).

Cette rubrique montre comment activer la file d’attente de notification sur votre vignette. Elle montre également comment baliser votre notification avant de l’envoyer, pour éviter d’introduire du contenu en double ou obsolète dans la file d’attente. Une fois la file d’attente de notification activée, Windows parcourt jusqu’à cinq notifications.

Pour accéder aux versions JavaScript des exemples fournis dans cette rubrique de démarrage rapide, voir Comment utiliser la file d’attente de notifications avec des notifications locales (JavaScript).

Remarque  Dans cette rubrique de démarrage rapide, vous allez manipuler le contenu de la notification directement via le modèle DOM (Document Object Model) XML. Une approche facultative est disponible via la bibliothèque NotificationsExtensions, présentant le contenu XML sous forme de propriétés d’objet, y compris IntelliSense. Pour plus d’informations, voir Démarrage rapide : utilisation de la bibliothèque NotificationsExtensions dans votre code. Pour accéder au code de cette rubrique de démarrage rapide exprimé à l’aide de NotificationsExtensions, voir l’exemple de vignettes et de badges d’application.

Ce que vous devez savoir

Technologies

  • Windows Runtime

Prérequis

Conditions préalables à la compréhension de cette rubrique :

Instructions

Étape 1: Ajouter des déclarations d’espace de noms

Windows.UI.Notifications inclut les API de toast.



using Windows.UI.Notifications;
using Windows.Data.Xml.Dom;

Étape 2: Définir l’option permettant d’activer le cycle de notification

Ce code active la file d’attente de notification de votre application. Cet appel doit être émis une seule fois pendant que l’application s’exécute, même si cela ne pose aucun problème de le renouveler. Nous vous conseillons de placer cet appel dans le code d’initialisation de votre application. Cela permet de s’assurer que l’appel est émis avant de mettre à jour la vignette localement, de demander un canal de notification Push ou de démarrer les mises à jour périodiques de la vignette.



TileUpdateManager.CreateTileUpdaterForApplication().EnableNotificationQueue(true);

Étape 3: Créer une notification par vignette

Il s’agit de la première étape pour toutes les notifications par vignette. Elle n’est nullement différente des autres situations et est incluse dans un souci d’exhaustivité. Pour plus d’informations, voir Démarrage rapide : Envoi d’une mise à jour de vignette.

Remarque  Quand GetTemplateContent est appelée sur un système Windows 8, elle retourne un modèle de version 1. Quand cette méthode est appelée sur un système Windows 8.1, elle retourne un modèle de version 2 ou un modèle de version 3 dans le cas de modèles pour Windows Phone uniquement. Toutefois, si une application spécifie la compatibilité Windows 8 dans son manifeste, cette méthode retourne un modèle de version 1 quelle que soit la version de Windows. Dans cette rubrique, nous allons utiliser un modèle de version 2.



TileUpdateManager.GetTemplateContent(TileTemplateType.TileWide310x150ImageAndText01);
XmlDocument tileXml = TileUpdateManager.GetTemplateContent(tileTemplate);

// TO DO: Fill in the template with your tile content. Define a tile and add it to tileXML.

TileNotification tileNotification = new TileNotification(tileXml);

Étape 4: Attribuer une balise à votre notification

Une balise est une chaîne composée au maximum de 16 caractères alphanumériques, auxquels s’ajoute un caractère Null de fin, qui identifie de manière unique sa notification au sein de votre application.

Lorsque la mise en file d’attente est activée, le cycle maximal de notifications par vignette est de cinq sur la vignette. Par défaut, la stratégie de remplacement des notifications dans la file d’attente est de type premier entré, premier sorti (FIFO). Quand la file d’attente est plein et qu’une nouvelle notification arrive, la notification la plus ancienne est supprimée. Notez que l’ordre d’affichage des notifications ne respecte pas de modèle linéaire strict. Les utilisateurs peuvent voir les notifications dans un ordre différent de celui dans lequel elles sont arrivées.

Pour remplacer le comportement FIFO de la file d’attente, une notification peut recevoir une balise. Si une nouvelle notification arrive avec la même balise qu’une notification existante, la nouvelle notification remplace l’ancienne quelle que soit la place de la plus ancienne notification dans la file d’attente. Si par exemple votre vignette indique des cours de bourse, vous voudrez montrer les informations les plus à jour. L’utilisation de balises pour remplacer les notifications dans la file d’attente est facultative.

Pour plus d’informations sur l’utilisation des balises avec la file d’attente de notifications, voir Utiliser la file d’attente de notifications. L’exemple ci-dessous indique comment définir la balise pour les notifications locales. Pour obtenir des informations sur la définition de balises pour les mises à jour périodiques, voir Tileupdater.StartPeriodicUpdateBatch. Pour obtenir des informations sur la définition de balises pour les notifications Push, voir En-têtes des demandes et des réponses du service de notifications Push.


tileNotification.Tag = "stockMSFT";

Étape 5: Envoyer la notification à la vignette



TileUpdateManager.CreateTileUpdaterForApplication().Update(tileNotification);

Rubriques associées

Démarrage rapide : envoi d’une mise à jour de vignette
Exemple de vignettes et de badges d’application
Tailles des images de vignette et de toast
Vue d’ensemble des vignettes et des notifications par vignette
Recommandations et liste de vérification sur les vignettes

 

 

Afficher:
© 2014 Microsoft