ScheduledTileNotification.Id Propriété

Définition

Espace de noms:

Windows.UI.Notifications

Obtient ou définit l’ID unique utilisé pour identifier la vignette planifiée dans la planification.

public:
 property Platform::String ^ Id { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring Id();

void Id(winrt::hstring value);

public string Id { get; set; }

var string = scheduledTileNotification.id;
scheduledTileNotification.id = string;

Public Property Id As String

Valeur de propriété

String

Platform::String

winrt::hstring

Identificateur de la notification. Cette chaîne est limitée à 16 caractères.

Exemples

L’exemple suivant, qui montre une vignette planifiée pour s’afficher dans une heure, inclut l’utilisation de la propriété Id pour étiqueter la notification planifiée.

var Notifications = Windows.UI.Notifications;
var currentTime = new Date();
var seconds = 60;
var dueTime = new Date(currentTime.getTime() + seconds * 60 * 1000);
var idNumber = 123456789;

var tileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileWide310x150Text09);

// Set up the wide tile text.
var tileTextAttributes = tileXml.getElementsByTagName("text");
tileTextAttributes[0].appendChild(tileXml.createTextNode("This is a scheduled notification"));
tileTextAttributes[1].appendChild(tileXml.createTextNode("Received: " + dueTime.toLocaleTimeString()));

// Set up the medium tile text.
var squareTileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileSquare150x150Text04);
var squareTileTextAttributes = squareTileXml.getElementsByTagName("text");
squareTileTextAttributes[0].appendChild(squareTileXml.createTextNode("This is a scheduled notification"));

// Include the medium tile in the notification.
var node = tileXml.importNode(squareTileXml.getElementsByTagName("binding").item(0), true);
tileXml.getElementsByTagName("visual").item(0).appendChild(node);

// Create the notification object.
var futureTile = new Notifications.ScheduledTileNotification(tileXml, dueTime);
futureTile.id = "Tile" + idNumber;

// Add to the schedule.
Notifications.TileUpdateManager.createTileUpdaterForApplication().addToSchedule(futureTile);

Remarques

ScheduledTileNotification.tag et ScheduledTileNotification.id servent des objectifs similaires :

• La propriété ScheduledTileNotification.tag est utilisée par Windows pour empêcher le contenu de notification en double d’apparaître dans la file d’attente en même temps. Elle permet de mettre à jour la notification sur place dans la file d’attente pour empêcher qu’elle contienne des informations obsolètes.
• La propriété id identifie la notification dans la planification. Cela permet d’identifier ou de supprimer la notification de la planification.