ToastNotificationManager Klasse

Definition

Namespace:

Windows.UI.Notifications

Erstellt ToastNotifier-Objekte , die Sie zum Auslösen von Popupbenachrichtigungen verwenden. Diese Klasse bietet auch Zugriff auf den XML-Inhalt der vom System bereitgestellten Popupvorlagen, sodass Sie diesen Inhalt für die Verwendung in Ihren Benachrichtigungen anpassen können.

public ref class ToastNotificationManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotificationManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class ToastNotificationManager

Public Class ToastNotificationManager

Vererbung

Object Platform::Object IInspectable ToastNotificationManager

Attribute

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)

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Popupbenachrichtigung erstellen und senden, die Text und Bilder enthält, einschließlich der Verwendung der Methoden GetTemplateContent und CreateToastNotifier .

var notifications = Windows.UI.Notifications;

// Get the toast notification manager for the current app.
var notificationManager = notifications.ToastNotificationManager;

// The getTemplateContent method returns a Windows.Data.Xml.Dom.XmlDocument object
// that contains the toast notification XML content.
var template = notifications.toastTemplateType.toastImageAndText01;
var toastXml = notificationManager.getTemplateContent(notifications.ToastTemplateType[template]);

// You can use the methods from the XML document to specify the required elements for the toast.
var images = toastXml.getElementsByTagName("image");
images[0].setAttribute("src", "images/toastImageAndText.png");

var textNodes = toastXml.getElementsByTagName("text");
textNodes.forEach(function (value, index) {
    var textNumber = index + 1;
    var text = "";
    for (var j = 0; j < 10; j++) {
        text += "Text input " + /*@static_cast(String)*/textNumber + " ";
    }
    value.appendChild(toastXml.createTextNode(text));
});

// Create a toast notification from the XML, then create a ToastNotifier object
// to send the toast.
var toast = new notifications.ToastNotification(toastXml);

notificationManager.createToastNotifier().show(toast);

Hinweise

Senden von Popupbenachrichtigungen von Desktop-Apps

Im Allgemeinen ist das Senden einer Popupbenachrichtigung von einer Desktop-App mit dem Senden von einer UWP-App identisch. Sie sollten jedoch die folgenden Unterschiede und Anforderungen kennen:

• Damit eine Desktop-App ein Popup anzeigt, muss die App über eine Verknüpfung auf dem Startbildschirm verfügen.
• Die Verknüpfung muss über eine AppUserModelID verfügen.
• Desktop-Apps können kein Popup planen.

Weitere Informationen finden Sie in den folgenden Themen:

• Aktivieren von Desktoppopupbenachrichtigungen über eine AppUserModelID
• Schnellstart: Senden einer Popupbenachrichtigung vom Desktop

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	ConfigureNotificationMirroring
1607	14393	GetForUser
1703	15063	GetDefault

Eigenschaften

History

Ruft das ToastNotificationHistory-Objekt ab.

Methoden

ConfigureNotificationMirroring(NotificationMirroring)	Gibt an, ob die Benachrichtigungsspiegelung zulässig ist. Durch die Benachrichtigungsspiegelung kann eine Benachrichtigung auf mehreren Geräten übertragen werden.
CreateToastNotifier()	Erstellt und initialisiert eine neue instance der ToastNotification, die an die aufrufende Anwendung gebunden ist, mit der Sie eine Popupbenachrichtigung für diese App auslösen können.
CreateToastNotifier(String)	Erstellt und initialisiert eine neue instance der ToastNotification, die an eine angegebene App gebunden ist, in der Regel eine andere App im selben Paket.
GetDefault()	Ruft einen Popupbenachrichtigungs-Manager für den aktuellen Benutzer ab.
GetForUser(User)	Ruft einen Popupbenachrichtigungs-Manager für den angegebenen Benutzer ab.
GetTemplateContent(ToastTemplateType)	Ruft den XML-Inhalt einer der vordefinierten Popupvorlagen ab, damit Sie ihn für die Verwendung in Ihrer Benachrichtigung anpassen können.

Weitere Informationen

• Beispiel für Popupbenachrichtigung
• Beispiel zum Senden von Toastbenachrichtigungen aus Desktop-Apps
• XML-Popupschema
• Übersicht über Popupbenachrichtigungen
• Schnellstart: Senden einer Popupbenachrichtigung
• Schnellstart: Senden einer Popup-Pushbenachrichtigung
• Schnellstart: Senden einer Popupbenachrichtigung vom Desktop
• Richtlinien und Prüfliste für Popupbenachrichtigungen
• Behandeln der Aktivierung über eine Popupbenachrichtigung
• Aktivieren von Popupbenachrichtigungen
• Planen einer Popupbenachrichtigung
• Aktivieren von Desktoppopupbenachrichtigungen über eine AppUserModelID
• Der Popupvorlagenkatalog
• Popupaudiooptionen