ScheduledTileNotification.Id Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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.