BadgeNotification Kelas

Definisi

Ruang nama:

Windows.UI.Notifications

Menentukan konten, metadata terkait, dan waktu kedaluwarsa pembaruan ke overlay lencana petak peta. Lencana dapat menampilkan angka dari 1 hingga 99 atau glyph 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

Warisan

Object Platform::Object IInspectable BadgeNotification

Atribut

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh kode berikut menggunakan metode BadgeNotification untuk membuat pemberitahuan lencana numerik. Jika Anda menggunakan metode ini untuk mengatur nilai ke "0", itu akan menghapus lencana.

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

Contoh kode berikut menggunakan metode BadgeNotification untuk membuat pemberitahuan lencana glyph. Jika Anda menggunakan metode ini untuk mengatur nilai ke "tidak ada", itu akan menghapus lencana.

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

Konstruktor

BadgeNotification(XmlDocument)

Membuat dan menginisialisasi instans baru BadgeNotification.

Properti

Content	Mendapatkan XML yang menentukan nilai atau glyph yang digunakan sebagai lencana petak peta.
ExpirationTime	Mendapatkan atau mengatur waktu Windows akan menghapus lencana dari petak peta. Secara default, pemberitahuan lencana lokal tidak kedaluwarsa dan pemberitahuan dorong, berkala, dan lencana terjadwal kedaluwarsa setelah tiga hari. Ini adalah praktik terbaik untuk secara eksplisit mengatur waktu kedaluwarsa untuk menghindari konten kedaluwarsa.

Lihat juga

• Sampel petak peta dan lencana aplikasi
• Gambaran umum lencana
• Panduan dan daftar periksa untuk petak dan lencana
• Cara menghapus lencana
• Cara mengirim lencana glyph atau numerik di pemberitahuan lokal
• Cara menyiapkan pemberitahuan berkala untuk lencana
• Cara memperbarui lencana melalui pemberitahuan push
• Skema XML lencana