BadgeNotification Klasse

Definition

Namespace:

Windows.UI.Notifications

Definiert den Inhalt, die zugeordneten Metadaten und die Ablaufzeit einer Aktualisierung der Badgeüberlagerung einer Kachel. Ein Badge kann eine Zahl von 1 bis 99 oder eine status Glyphe anzeigen.

public ref class BadgeNotification 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.IBadgeNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeNotification 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.IBadgeNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeNotification

function BadgeNotification(content)

Public NotInheritable Class BadgeNotification

Vererbung

Object Platform::Object IInspectable BadgeNotification

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 Beispielcode wird die BadgeNotification-Methode verwendet, um eine numerische Signalbenachrichtigung zu erstellen. Wenn Sie diese Methode verwendet haben, um den Wert auf "0" festzulegen, würde das Signal gelöscht.

var Notifications = Windows.UI.Notifications;

var badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "26");

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

Im folgenden Beispielcode wird die BadgeNotification-Methode verwendet, um eine Glyphen-Signalbenachrichtigung zu erstellen. Wenn Sie diese Methode verwendet haben, um den Wert auf "none" festzulegen, würde das Signal gelöscht.

var Notifications = Windows.UI.Notifications;

var badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "alert");

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

Konstruktoren

BadgeNotification(XmlDocument)

Erstellt und initialisiert eine neue instance von BadgeNotification.

Eigenschaften

Content	Ruft den XML-Code ab, der den Wert oder die Glyphe definiert, die als Signal der Kachel verwendet wird.
ExpirationTime	Ruft die Zeit ab, zu der Windows den Badge aus der Kachel entfernt, oder legt diese fest. Standardmäßig laufen lokale Signalbenachrichtigungen nicht ab, und Push-, periodische und geplante Signalbenachrichtigungen laufen nach drei Tagen ab. Es empfiehlt sich, explizit eine Ablaufzeit festzulegen, um veraltete Inhalte zu vermeiden.

Weitere Informationen

• Beispiel für App-Kacheln und -Badges
• Übersicht über Badges
• Richtlinien und Prüfliste für Kacheln und Signale
• Löschen eines Badges
• Senden einer Glyphe oder eines numerischen Badges in einer lokalen Benachrichtigung
• So wird's gemacht: Einrichten regelmäßiger Benachrichtigungen für Signale
• So wird's gemacht: Aktualisieren eines Signals durch Pushbenachrichtigungen
• Signal-XML-Schema