ToastNotification Klasse

Definition

Namespace:

Windows.UI.Notifications

Definiert den Inhalt, die zugeordneten Metadaten und Ereignisse sowie die Ablaufzeit einer Popupbenachrichtigung.

public ref class ToastNotification 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.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification 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.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotification

function ToastNotification(content)

Public NotInheritable Class ToastNotification

Vererbung

Object Platform::Object IInspectable ToastNotification

Attribute

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Anleitungen zum Implementieren von Popupbenachrichtigungen in Ihrer App finden Sie unter Senden einer lokalen Popupbenachrichtigung von C#-Apps.

Leitfaden zum Behandeln der App-Aktivierung für Popupbenachrichtigungen:

• UWP-Anwendungen sollten onActivated verwenden, um Popupaktivierungen zu behandeln.
• Ab WinRT Build 19041 können gepackte Apps (einschließlich gepackter Apps mit externem Speicherort) ToastNotificationActionTrigger für die Behandlung von Aktivierungen verwenden, um weitere Details zu erhalten.
• Desktop-Apps können die COM-Aktivierung verwenden, indem Sie desktop – Send Local Toast (Desktop – Lokales Popup senden) folgen.
• Wenn keine der Aktivierungsoptionen für Ihre Anwendung geeignet ist, befolgen Sie das Beispiel in diesem Dokument für die ordnungsgemäße Verwendung von Ereignishandlern.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	NotificationMirroring
1607	14393	RemoteId
1703	15063	Daten
1703	15063	Priority
1903	18362	ExpiresOnReboot

Konstruktoren

ToastNotification(XmlDocument)

Erstellt und initialisiert eine neue instance von ToastNotification.

Eigenschaften

Content	Ruft den XML-Code ab, der die aktuelle Popupbenachrichtigung definiert.
Data	Ruft zusätzliche Informationen zur status der Popupbenachrichtigung ab oder legt diese fest.
ExpirationTime	Ruft die Zeit ab, nach der eine Popupbenachrichtigung nicht angezeigt werden soll, oder legt diese fest.
ExpiresOnReboot	Gibt an, ob die Popupbenachrichtigung nach einem Neustart im Info-Center verbleibt.
Group	Ruft den Gruppenbezeichner für die Benachrichtigung ab oder legt diese fest.
NotificationMirroring	Ruft einen Wert ab, der angibt, ob die Benachrichtigungsspiegelung zulässig ist, oder legt diesen fest.
Priority	Ruft die Priorität der Popupbenachrichtigung ab oder legt sie fest.
RemoteId	Ruft eine Remote-ID für die Benachrichtigung ab, mit der das System diese Benachrichtigung mit einer anderen Benachrichtigung korrelieren kann, die auf einem anderen Gerät generiert wird, oder legt diese fest.
SuppressPopup	Ruft ab oder legt fest, ob die Popup-Benutzeroberfläche eines Popups auf dem Bildschirm des Benutzers angezeigt wird.
Tag	Ruft den eindeutigen Bezeichner dieser Benachrichtigung innerhalb der Benachrichtigungsgruppe ab oder legt diesen fest.

Ereignisse

Activated	Tritt auf, wenn der Benutzer eine Popupbenachrichtigung durch einen Klick oder eine Toucheingabe aktiviert. Apps, die ausgeführt werden, abonnieren dieses Ereignis.
Dismissed	Tritt auf, wenn eine Popupbenachrichtigung den Bildschirm verlässt, entweder durch Ablauf oder durch den Benutzer explizit geschlossen wird. Apps, die ausgeführt werden, abonnieren dieses Ereignis.
Failed	Tritt auf, wenn ein Fehler verursacht wird, wenn Windows versucht, eine Popupbenachrichtigung auszulösen. Apps, die ausgeführt werden, abonnieren dieses Ereignis.

Weitere Informationen

• Beispiel für Popupbenachrichtigung
• Beispiel zum Senden von Toastbenachrichtigungen aus Desktop-Apps
• Xml-Schema für Popups
• Kacheln, Signale und Benachrichtigungen
• Schnellstart: Senden einer Popupbenachrichtigung
• Schnellstart: Senden einer Popuppushbenachrichtigung
• Schnellstart: Senden einer Popupbenachrichtigung vom Desktop
• Richtlinien und Prüfliste für Popupbenachrichtigungen
• Behandeln der Aktivierung über eine Popupbenachrichtigung
• So melden Sie sich für Popupbenachrichtigungen an
• Planen einer Popupbenachrichtigung
• Aktivieren von Desktoppopupbenachrichtigungen über eine AppUserModelID
• Der Popupvorlagenkatalog
• Popupaudiooptionen