BadgeNotification Classe

Définition

Espace de noms:

Windows.UI.Notifications

Définit le contenu, les métadonnées associées et l’heure d’expiration d’une mise à jour de la superposition de badge d’une vignette. Un badge peut afficher un nombre compris entre 1 et 99 ou un glyphe status.

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

Héritage

Object Platform::Object IInspectable BadgeNotification

Attributs

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de code suivant utilise la méthode BadgeNotification pour créer une notification de badge numérique. Si vous avez utilisé cette méthode pour définir la valeur « 0 », le badge est effacé.

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

L’exemple de code suivant utilise la méthode BadgeNotification pour créer une notification de badge glyphe. Si vous avez utilisé cette méthode pour définir la valeur « none », le badge est effacé.

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

Constructeurs

BadgeNotification(XmlDocument)

Crée et initialise une nouvelle instance de badgeNotification.

Propriétés

Content	Obtient le code XML qui définit la valeur ou le glyphe utilisé comme badge de la vignette.
ExpirationTime	Obtient ou définit l’heure à laquelle Windows supprime le badge de la vignette. Par défaut, les notifications de badge local n’expirent pas et les notifications push, périodiques et planifiées expirent au bout de trois jours. Il est recommandé de définir explicitement un délai d’expiration pour éviter le contenu obsolète.

Voir aussi

• Exemple de vignettes et de badges d’application
• Vue d’ensemble du badge
• Recommandations et liste de vérification sur les vignettes et les badges
• Comment effacer un badge
• Comment envoyer un glyphe ou un badge numérique dans une notification locale
• Comment configurer des notifications périodiques pour les badges
• Comment mettre à jour un badge via des notifications Push
• Schéma XML de badge