TileNotification Klasse

Definition

Namespace:

Windows.UI.Notifications

Definiert ein Update für eine Kachel, einschließlich ihrer Visuellen Elemente, des Identifikationstags und der Ablaufzeit.

public ref class TileNotification sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.ITileNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class TileNotification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.ITileNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class TileNotification

function TileNotification(content)

Public NotInheritable Class TileNotification

Vererbung

Object Platform::Object IInspectable TileNotification

Attribute

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Im folgenden Beispiel wird der TileNotification-Konstruktor verwendet, um eine neue instance zu erstellen. Anschließend wird die ExpirationTime-Eigenschaft verwendet, um eine Kachelbenachrichtigung für 30 Sekunden anzuzeigen.

function tileNotificationExpiration() {
    var Notifications = Windows.UI.Notifications;
    var tileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileWide310x150Text04);

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

Konstruktoren

TileNotification(XmlDocument)

Erstellt und initialisiert eine neue instance des TileNotification-Objekts zur Verwendung mit einem TileUpdater.

Eigenschaften

Content	Ruft die XML-Beschreibung des Benachrichtigungsinhalts ab, den Sie ändern können, um die Benachrichtigung zu ändern.
ExpirationTime	Ruft die Zeit ab, zu der Windows die Benachrichtigung von der Kachel entfernt, oder legt sie fest. Standardmäßig läuft ein Kachelupdate nicht ab. Es empfiehlt sich, explizit eine Ablaufzeit festzulegen, um veraltete Inhalte zu vermeiden.
Tag	Ruft eine Zeichenfolge ab, die Windows verwenden kann, um zu verhindern, dass doppelte Benachrichtigungsinhalte in der Warteschlange angezeigt werden, oder legt diese fest.

Weitere Informationen

• Beispiel für App-Kacheln und -Badges
• Schnellstart: Senden eines Kachelupdates
• Übersicht über Kachel- und Kachelbenachrichtigungen
• Der Kachelvorlagenkatalog
• Richtlinien und Prüfliste für Kacheln
• Planen einer Kachelbenachrichtigung
• So wird's gemacht: Einrichten regelmäßiger Benachrichtigungen für Kacheln
• XML-Schema für Kacheln