BadgeUpdater Klasse

Referenz

Definition

Namespace:: Windows.UI.Notifications

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Updates eine Signalüberlagerung auf der bestimmten Kachel, an die der Updater gebunden ist.

public ref class BadgeUpdater sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class BadgeUpdater final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdater final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class BadgeUpdater

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeUpdater

Public NotInheritable Class BadgeUpdater

Vererbung: Object Platform::Object IInspectable BadgeUpdater

Attribute: ContractVersionAttribute 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

Das folgende Beispiel zeigt die Verwendung von Update , um ein numerisches Signalupdate an die Kachel der aufrufenden App zu senden.

function sendBadgeNotification() {
    var Notifications = Windows.UI.Notifications;
    var badgeXml;
    var badgeAttributes;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
    badgeAttributes = badgeXml.getElementsByTagName("badge");
    badgeAttributes[0].setAttribute("value", "7");

    // Create a badge notification from the XML content.
    var badgeNotification = new Notifications.BadgeNotification(badgeXml);

    // Send the badge notification to the app's tile.
    Notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().update(badgeNotification);
}

Hinweise

Um eine instance dieses Objekts abzurufen, rufen Sie die BadgeUpdateManager.CreateBadgeUpdaterForApplication- oder BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile-Methode auf.

Bei der Erstellung wird BadgeUpdater an eine bestimmte App oder sekundäre Kachel gebunden, sodass die Methoden dieser Klasse nur die einzelne Kachel beeinflussen, an die das Objekt instance gebunden ist.

Methoden

Clear()	Entfernt den Badge aus der Kachel, an die der Updater gebunden ist.
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)	Startet eine Reihe von zeitlimitierten Updates für den Badge aus einer Webressource, an die der Updater gebunden ist. Updates zu einem bestimmten Zeitpunkt beginnen. Beachten Sie, dass in regelmäßigen Updates nur Webressourcen (http/https) zulässig sind.
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)	Startet eine Reihe von zeitlimitierten Updates für den Badge aus einer Webressource, an die der Updater gebunden ist, und beginnt sofort. Beachten Sie, dass in regelmäßigen Updates nur Webressourcen (http/https) zulässig sind.
StopPeriodicUpdate()	Bricht die aktuelle Reihe zeitgebundener Updates für den Badge ab, an den der Updater gebunden ist.
Update(BadgeNotification)	Wendet eine Änderung auf die Glyphe oder Nummer des Badges an.

Gilt für:

Freigeben über