BadgeNotification 클래스

정의

네임스페이스:

Windows.UI.Notifications

타일의 배지 오버레이에 대한 업데이트의 콘텐츠, 연결된 메타데이터 및 만료 시간을 정의합니다. 배지는 1에서 99까지의 숫자 또는 상태 문자 모양을 표시할 수 있습니다.

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

상속

Object Platform::Object IInspectable BadgeNotification

특성

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

다음 예제 코드에서는 BadgeNotification 메서드를 사용하여 숫자 배지 알림을 만듭니다. 이 메서드를 사용하여 값을 "0"으로 설정하면 배지가 지워지게 됩니다.

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

다음 예제 코드에서는 BadgeNotification 메서드를 사용하여 문자 모양 배지 알림을 만듭니다. 이 메서드를 사용하여 값을 "none"으로 설정하면 배지가 지워지게 됩니다.

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

생성자

BadgeNotification(XmlDocument)

BadgeNotification의 새 instance 만들고 초기화합니다.

속성

Content	타일의 배지로 사용되는 값 또는 문자 모양을 정의하는 XML을 가져옵니다.
ExpirationTime	Windows가 타일에서 배지를 제거하는 시간을 가져오거나 설정합니다. 기본적으로 로컬 배지 알림은 만료되지 않으며 푸시, 정기 및 예약된 배지 알림은 3일 후에 만료됩니다. 부실 콘텐츠를 방지하기 위해 만료 시간을 명시적으로 설정하는 것이 좋습니다.

추가 정보

• 앱 타일 및 배지 샘플
• 배지 개요
• 타일 및 배지에 대한 지침 및 검사 목록
• 배지를 지우는 방법
• 로컬 알림에서 문자 모양 또는 숫자 배지를 보내는 방법
• 배지에 대해 정기 알림을 설정하는 방법
• 푸시 알림을 통해 배지를 업데이트하는 방법
• 배지 XML 스키마