ScheduledTileNotification.Id Eigenschaft

Definition

Namespace:

Windows.UI.Notifications

Ruft die eindeutige ID ab, die zum Identifizieren der geplanten Kachel im Zeitplan verwendet wird, oder legt diese fest.

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

Eigenschaftswert

String

Platform::String

winrt::hstring

Der Bezeichner der Benachrichtigung. Diese Zeichenfolge ist auf 16 Zeichen beschränkt.

Beispiele

Das folgende Beispiel zeigt eine Kachel, die in einer Stunde angezeigt werden soll, umfasst die Verwendung der Id-Eigenschaft zum Bezeichnen der geplanten Benachrichtigung.

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);

Hinweise

ScheduledTileNotification.tag und ScheduledTileNotification.id dienen ähnlichen Zwecken:

• Die ScheduledTileNotification.tag-Eigenschaft wird von Windows verwendet, um zu verhindern, dass doppelte Benachrichtigungsinhalte gleichzeitig in der Warteschlange angezeigt werden. Dadurch kann die Benachrichtigung an Ort und Stelle in der Warteschlange aktualisiert werden, um zu verhindern, dass sie veraltete Informationen enthält.
• Die id-Eigenschaft identifiziert die Benachrichtigung im Zeitplan. Dadurch kann die Benachrichtigung identifiziert oder aus dem Zeitplan entfernt werden.