BadgeNotification Classe

Definizione

Spazio dei nomi:

Windows.UI.Notifications

Definisce il contenuto, i metadati associati e l'ora di scadenza di un aggiornamento alla sovrapposizione di badge di un riquadro. Un badge può visualizzare un numero compreso tra 1 e 99 o un glifo di stato.

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

Ereditarietà

Object Platform::Object IInspectable BadgeNotification

Attributi

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Il codice di esempio seguente usa il metodo BadgeNotification per creare una notifica di notifica numerica. Se si usa questo metodo per impostare il valore su "0", deselezionare il badge.

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

Il codice di esempio seguente usa il metodo BadgeNotification per creare una notifica di notifica del glifo. Se si usa questo metodo per impostare il valore su "nessuno", deselezionare il badge.

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

Costruttori

BadgeNotification(XmlDocument)

Crea e inizializza una nuova istanza di BadgeNotification.

Proprietà

Content	Ottiene il codice XML che definisce il valore o il glifo usato come badge del riquadro.
ExpirationTime	Ottiene o imposta l'ora in cui Windows rimuoverà il badge dal riquadro. Per impostazione predefinita, le notifiche di notifica locali non scadono e eseguono la scadenza, periodica e pianificata delle notifiche badge dopo tre giorni. È consigliabile impostare in modo esplicito un'ora di scadenza per evitare il contenuto non aggiornato.

Vedi anche

• Esempio di riquadri e badge dell'app
• Panoramica dei badge
• Linee guida ed elenco di controllo per i riquadri e le notifiche visuali
• Come cancellare un badge
• Come inviare un glifo o un badge numerico in una notifica locale
• Come configurare avvisi periodici per le notifiche
• Come aggiornare una notifica tramite notifiche push
• Schema XML badge