Freigeben über


TileUpdater Klasse

Definition

Ändert den Inhalt der bestimmten Kachel, an die der Updater gebunden ist.

public ref class TileUpdater sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TileUpdater final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class TileUpdater final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TileUpdater
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class TileUpdater
Public NotInheritable Class TileUpdater
Vererbung
Object Platform::Object IInspectable TileUpdater
Attribute

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

Das folgende Beispiel zeigt Update , das zum Senden einer Benachrichtigung an die Kachel der App verwendet wird.

function sendTileTextNotification() {
    var Notifications = Windows.UI.Notifications;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    var tileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileWide310x150Text03);

    // You will need to look at the template documentation to know how many text fields a particular template has.
    // Get the text attribute for this template and fill it in.
    var tileAttributes = tileXml.getElementsByTagName("text");
    tileAttributes[0].appendChild(tileXml.createTextNode("Hello World!"));

    // Create the notification from the XML.
    var tileNotification = new Notifications.TileNotification(tileXml);

    // Send the notification to the calling app's tile.
    Notifications.TileUpdateManager.createTileUpdaterForApplication().update(tileNotification);
}

In der folgenden Codezeile wird EnableNotificationQueue verwendet, um die Benachrichtigungswarteschlange für die Kachel der aufrufenden App zu aktivieren.

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

Das folgende Beispiel zeigt die Verwendung der RemoveFromSchedule-Methode .

var notifier = Notifications.TileUpdateManager.createTileUpdaterForApplication();
var scheduled = notifier.getScheduledTileNotifications();

for (var i = 0, len = scheduled.length; i < len; i++) {

    // The itemId value is the unique ScheduledTileNotification.Id assigned to the 
    // notification when it was created.
    if (scheduled[i].id === itemId) {
        notifier.removeFromSchedule(scheduled[i]);
    }
}

Hinweise

Um eine instance dieses Objekts abzurufen, rufen Sie die Methode TileUpdateManager.CreateTileUpdaterForApplication oder TileUpdateManager.CreateTileUpdaterForSecondaryTile auf.

Beim Erstellen ist TileUpdater an eine bestimmte App oder sekundäre Kachel gebunden, sodass sich die Methoden dieser Klasse nur auf die einzelne Kachel auswirken, an die das Objekt instance gebunden ist.

Eigenschaften

Setting

Ruft einen Wert ab, der angibt, ob eine Kachel über Benachrichtigungen aktualisiert werden kann.

Methoden

AddToSchedule(ScheduledTileNotification)

Fügt dem Zeitplan eine ScheduledTileNotification hinzu.

Clear()

Entfernt alle Updates und bewirkt, dass die Kachel ihren Standardinhalt wie im Manifest der App deklariert anzeigt.

EnableNotificationQueue(Boolean)

Ermöglicht die Kachel, bis zu fünf Benachrichtigungen in die Warteschlange zu stellen. Dadurch wird die Benachrichtigungswarteschlange für alle Kachelgrößen aktiviert.

EnableNotificationQueueForSquare150x150(Boolean)

Ermöglicht der Kachel, bis zu fünf Benachrichtigungen auf der mittleren Kachel in die Warteschlange zu stellen.

EnableNotificationQueueForSquare310x310(Boolean)

Ermöglicht der Kachel, bis zu fünf Benachrichtigungen auf der großen Kachel in die Warteschlange zu stellen.

EnableNotificationQueueForWide310x150(Boolean)

Ermöglicht der Kachel, bis zu fünf Benachrichtigungen auf der breiten Kachel in die Warteschlange zu stellen.

GetScheduledTileNotifications()

Ruft eine Liste geplanter Updates für die Kachel ab.

RemoveFromSchedule(ScheduledTileNotification)

Entfernt ein bevorstehendes Kachelupdate aus dem Zeitplan.

StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)

Startet eine Reihe von Zeitupdates für die Kachel, an die der Updater gebunden ist. Der Updateinhalt wird von einem angegebenen URI (Uniform Resource Identifier) abgerufen. Updates zu einem angegebenen Zeitpunkt beginnen.

StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)

Startet eine Reihe von zeitlich begrenzten Inhaltsänderungen für die Kachel, an die der Updater gebunden ist, und beginnt sofort.

StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)

Beginnt eine Reihe von zeitgebundenen Updates, die auf der Kachel, an die der Updater gebunden ist, ausgeführt werden. Aktualisierungsinhalte werden aus einem Array des angegebenen URI (Uniform Resource Identifier) abgerufen, wobei Updates zu einem bestimmten Zeitpunkt beginnen und nachfolgende Updates im periodischen Intervall danach auftreten.

Hinweis

Um dieses Feature verwenden zu können, müssen Sie zuerst die Benachrichtigungswarteschlange der Kachel aktivieren, indem Sie EnableNotificationQueue aufrufen.

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)

Beginnt eine Reihe von zeitgebundenen Updates, die auf der Kachel, an die der Updater gebunden ist, ausgeführt werden. Der Aktualisierungsinhalt wird aus einem Array des angegebenen URI (Uniform Resource Identifier) abgerufen. Das erste Update erfolgt sofort und nachfolgende Updates erfolgen im regelmäßigen Intervall danach.

Hinweis

Um dieses Feature verwenden zu können, müssen Sie zuerst die Benachrichtigungswarteschlange der Kachel aktivieren, indem Sie EnableNotificationQueue aufrufen.

StopPeriodicUpdate()

Bricht die aktuelle Reihe von zeitgebundenen Updates für die Kachel ab, an die der Updater gebunden ist.

Update(TileNotification)

Wendet eine Änderung des Inhalts oder der Darstellung auf die Kachel an.

Gilt für: