Gets or sets the time that Windows will remove the notification from the tile. By default, a tile update does not expire. It is a best practice to explicitly set an expiration time to avoid stale content.
Syntax
var expirationTime = tileNotification.expirationTime;
tileNotification.expirationTime = expirationTime;
Property value
Type: IReference<DateTime> [JavaScript/C++] | System.Nullable<DateTime> [.NET]
The date and time that the notification should be removed.
Examples
The following example uses ExpirationTime to show a tile notification for 30 seconds.
function tileNotificationExpiration() { var Notifications = Windows.UI.Notifications; var tileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileWideText04); var currentTime = new Date(); var seconds = 30; var tileTextAttributes = tileXml.getElementsByTagName("text"); tileTextAttributes[0].appendChild(tileXml.createTextNode("This notification will expire at " + new Date(currentTime.getTime() + seconds * 1000))); var tileNotification = new Notifications.TileNotification(tileXml); // Set the expiration time on the notification var expiryTime = new Date(currentTime.getTime() + seconds * 1000); tileNotification.expirationTime = expiryTime; Notifications.TileUpdateManager.createTileUpdaterForApplication().update(tileNotification); }
Requirements
|
Minimum supported client | Windows 8 |
|---|---|
|
Minimum supported server | Windows Server 2012 |
|
Namespace |
|
|
Metadata |
|
See also
- TileNotification
- How to use the notification queue with local notifications
- App tiles and badges sample
- Quickstart: Sending a tile update
- Tile and tile notification overview
- The tile template catalog
- Guidelines and checklist for tiles
- How to schedule a tile notification
- How to set up periodic notifications for tiles
- Tiles XML schema
Build date: 12/4/2012