Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Windows innehåller flera meddelande-API:er i olika SDK-generationer. Om du söker online efter hur du skickar ett meddelande och hittar motstridiga exempel, hjälper den här sidan dig att välja rätt API för din app.
Vilket API ska jag använda?
Svaret beror på vilken SDK som appen riktar in sig på:
| Apptyp | Rekommenderat API | Namespace |
|---|---|---|
| WinUI 3/Windows App SDK (nya appar) | AppNotificationManager |
Microsoft.Windows.AppNotifications |
| WPF, WinForms eller opaketerad Win32 |
AppNotificationManager via NuGet |
Microsoft.Windows.AppNotifications |
| UWP (befintliga appar, ingen planerad migrering) | ToastNotificationManager |
Windows.UI.Notifications |
Viktigt!
De flesta Stack Overflow-svar och äldre handledningar använder ToastNotificationManager från namnområdet Windows.UI.Notifications. Det här är UWP WinRT API. Det fungerar i UWP-appar och kan fungera i vissa skrivbordsscenarier, men det är inte den rekommenderade sökvägen för nya Windows App SDK appar. Använd AppNotificationManager för ny utveckling.
Jämförelse av API för meddelanden
| Feature |
AppNotificationManager (Windows App SDK) |
ToastNotificationManager (WinRT) |
|---|---|---|
| Rekommenderas för | WinUI 3, WPF, WinForms, icke-packeterad Win32 | Universal Windows-plattform (UWP) |
| NuGet-paket | Microsoft.WindowsAppSDK |
Ingen (inkorg) |
| Paketidentitet krävs | Nej (verk paketerade och uppackade) | Krävs för vissa funktioner |
| Push-integrering |
PushNotificationManager (Windows App SDK) |
WNS-kanal-API:er (Windows.Networking.PushNotifications) |
| Aktiv utveckling | Ja | Endast underhåll |
Typer av meddelanden
När du har valt rätt API bestämmer du hur meddelandet ska levereras:
| Type | Beskrivning | Använd när |
|---|---|---|
| Meddelande om lokal app | Utlöses direkt av din appkod när du kör | Du vill varna användaren om en händelse i appen |
| Scheduled | Ange en framtida tid för att meddelandet ska visas | Kalenderpåminnelser, larm |
| Push (WNS) | Skickas från molntjänsten via Windows Push Notification Services | Chattmeddelanden, senaste nytt, realtidsuppdateringar |
| Badge | Litet överlägg på appens aktivitetsfältikon | Antal olästa, statusindikator |
En fullständig uppdelning av leveransmetoder finns i Välj en meddelandeleveransmetod.
Nästa steg
Skapa en WinUI 3- eller Windows App SDK-app?
-
Översikt över appaviseringar – lokala meddelanden och push-meddelanden med hjälp av
AppNotificationManager - Snabbstart för appaviseringar
-
Översikt över push-meddelanden – WNS-push med hjälp av
PushNotificationManager
Skapa en WPF- eller WinForms-app?
- Snabbstart för appmeddelanden – lokala popup-meddelanden fungerar paketerade eller uppackade
- Snabbstart för push-meddelanden – WNS-push stöder en begränsad verkligen opaketerad sökväg, men paketering (MSIX eller förpackad med extern plats lagring) krävs för bakgrundsleverans och COM-aktivering
Viktigt!
Windows App SDK push-meddelanden kräver ett Azure konto och en Azure AD-appregistrering. Om din app paketeras måste du också skicka en PFN-mappningsbegäran (Paketfamiljenamn) via e-post – med upp till en veckas bearbetningstid innan den startas. Se snabbstarten för push-meddelanden för fullständiga krav.
Skapa eller underhålla en UWP-app?
- Skicka ett meddelande om lokal app från C++ UWP-appar
- översikt över Windows Push Notification Services (WNS)
Migrera en UWP-app till Windows App SDK?
Samarbeta med oss på GitHub
Källan för det här innehållet finns på GitHub, där du även kan skapa och granska ärenden och pull-begäranden. Se vår deltagarguide för mer information.
Windows developer