Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Windows stellt verschiedene Benachrichtigungs-APIs über verschiedene SDK-Generationen bereit. Wenn Sie online suchen, wie Sie eine Benachrichtigung senden und konfliktende Beispiele finden, hilft Ihnen diese Seite bei der Auswahl der richtigen API für Ihre App.
Welche API sollte ich verwenden?
Die Antwort hängt davon ab, auf welches SDK Ihre App ausgerichtet ist:
| App-Typ | Empfohlene API | Namespace |
|---|---|---|
| WinUI 3 / Windows App SDK (neue Apps) | AppNotificationManager |
Microsoft.Windows.AppNotifications |
| WPF, WinForms oder nicht gepackte Win32 |
AppNotificationManager über NuGet |
Microsoft.Windows.AppNotifications |
| UWP (vorhandene Apps, keine geplante Migration) | ToastNotificationManager |
Windows.UI.Notifications |
Von Bedeutung
Die meisten Stack Overflow-Antworten und ältere Lernprogramme verwenden ToastNotificationManager aus dem Namespace Windows.UI.Notifications. Dies ist die UWP WinRT-API. Es funktioniert in UWP-Apps und kann in einigen Desktopszenarien funktionieren, ist aber nicht der empfohlene Pfad für neue Windows App SDK-Apps. Verwenden Sie AppNotificationManager für neue Entwicklungen.
Vergleich der Benachrichtigungs-API
| Funktion |
AppNotificationManager (Windows App SDK) |
ToastNotificationManager (WinRT) |
|---|---|---|
| Empfohlen für | WinUI 3, WPF, WinForms, nicht gepackte Win32 | UWP (Universelle Windows-Plattform) |
| NuGet-Paket | Microsoft.WindowsAppSDK |
Keine (Posteingang) |
| Paketidentität erforderlich | Nein (verpackt und unverpackt) | Erforderlich für einige Features |
| Pushintegration |
PushNotificationManager (Windows App SDK) |
WNS-Kanal-APIs (Windows.Networking.PushNotifications) |
| Aktive Entwicklung | Ja | Nur Wartung |
Arten von Benachrichtigungen
Nachdem Sie die richtige API ausgewählt haben, entscheiden Sie, wie Ihre Benachrichtigung übermittelt wird:
| Typ | Beschreibung | Verwenden Sie, wenn |
|---|---|---|
| Lokale App-Benachrichtigung | Wird während der Ausführung direkt vom App-Code ausgelöst | Sie möchten den Benutzer über ein In-App-Ereignis benachrichtigen. |
| Geplant | Festlegen einer zukünftigen Zeit für die Anzeige der Benachrichtigung | Kalendererinnerungen, Alarme |
| Push (WNS) | Gesendet von Ihrem Clouddienst über Windows Pushbenachrichtigungsdienste | Chatnachrichten, Aktuelle Nachrichten, Echtzeitupdates |
| Abzeichen | Kleine Überlagerung auf dem Taskleistensymbol der App | Ungelesene Anzahl, Statusanzeige |
Eine vollständige Aufschlüsselung der Übermittlungsmethoden finden Sie unter Auswählen einer Benachrichtigungsübermittlungsmethode.
Nächste Schritte
Eine WinUI 3- oder Windows App SDK-Anwendung erstellen?
-
Übersicht über App-Benachrichtigungen – lokale und Push-App-Benachrichtigungen mit
AppNotificationManager - Schnellstart für App-Benachrichtigungen
-
Übersicht über Pushbenachrichtigungen – WNS-Push mit
PushNotificationManager
Erstellen Sie eine WPF- oder WinForms-App?
- App-Benachrichtigungen Schnellstart – lokale Toastbenachrichtigungen funktionieren verpackt oder entpackt
- Schnellstart für Pushbenachrichtigungen – WNS-Push unterstützt einen begrenzten, vollständig entpackten Pfad, aber das Verpacken (MSIX oder verpackt mit externem Speicherort) ist für die Hintergrundbereitstellung und COM-Aktivierung erforderlich.
Von Bedeutung
Windows App SDK Pushbenachrichtigungen erfordern ein Azure-Konto und eine Azure AD-App-Registrierung. Wenn Ihre App verpackt ist, müssen Sie auch eine PFN-Zuordnungsanforderung (Paketfamilienname) per E-Mail übermitteln. Sie können bis zu einer Woche Verarbeitungszeit vor dem Start zulassen. Sehen Sie sich die Schnellstartanleitung für Pushbenachrichtigungen an, um vollständige Voraussetzungen zu erhalten.
Erstellen oder Verwalten einer UWP-App?
- Senden einer lokalen App-Benachrichtigung aus C++-UWP-Apps
- Übersicht über Windows Push notification Services (WNS)
Migrating einer UWP-App zum Windows App SDK?
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
Windows developer