BadgeUpdater Classe

Definizione

Spazio dei nomi:

Windows.UI.Notifications

Aggiornamenti una sovrimpressione badge nel riquadro specifico a cui è associato l'updater.

public ref class BadgeUpdater sealed

/// [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)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeUpdater

Public NotInheritable Class BadgeUpdater

Ereditarietà

Object Platform::Object IInspectable BadgeUpdater

Attributi

ContractVersionAttribute 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

L'esempio seguente mostra l'uso di Update per inviare un aggiornamento numerico della notifica al riquadro dell'app chiamante.

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

Commenti

Per ottenere un'istanza di questo oggetto, chiamare il metodo BadgeUpdateManager.CreateBadgeUpdaterForApplication o BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile .

Quando viene creato, BadgeUpdater è associato a un'app specifica o a un riquadro secondario, quindi i metodi di questa classe influiscono solo sul singolo riquadro a cui è associata l'istanza dell'oggetto.

Metodi

Clear()	Rimuove il badge dal riquadro a cui è associato l'updater.
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)	Avvia una serie di aggiornamenti temporali per la notifica da una risorsa Web a cui è associato l'updater. Aggiornamenti iniziare a un'ora specificata. Si noti che solo le risorse Web (http/https) sono consentite in un aggiornamento periodico.
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)	Inizia una serie di aggiornamenti a tempo per il badge da una risorsa Web a cui è associato l'updater, a partire immediatamente. Si noti che solo le risorse Web (http/https) sono consentite in un aggiornamento periodico.
StopPeriodicUpdate()	Annulla la serie corrente di aggiornamenti a tempo per la notifica a cui è associato l'updater.
Update(BadgeNotification)	Applica una modifica al glifo o al numero del badge.

Vedi anche

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