Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Windows biedt verschillende meldings-API's voor verschillende SDK-generaties. Als u online zoekt naar het verzenden van een melding en het vinden van conflicterende voorbeelden, helpt deze pagina u bij het kiezen van de juiste API voor uw app.
Welke API moet ik gebruiken?
Het antwoord is afhankelijk van de SDK waarop uw app is gericht:
| Type van app | Aanbevolen API | Namespace |
|---|---|---|
| WinUI 3/Windows App SDK (nieuwe apps) | AppNotificationManager |
Microsoft.Windows.AppNotifications |
| WPF, WinForms of niet-gepackageerde Win32 |
AppNotificationManager via NuGet |
Microsoft.Windows.AppNotifications |
| UWP (bestaande apps, geen migratie gepland) | ToastNotificationManager |
Windows.UI.Notifications |
Belangrijk
De meeste Stack Overflow-antwoorden en oudere handleidingen gebruiken ToastNotificationManager uit de Windows.UI.Notifications namespace. Dit is de UWP WinRT-API. Het werkt in UWP-apps en werkt mogelijk in sommige bureaubladscenario's, maar het is niet het aanbevolen pad voor nieuwe Windows App SDK-apps. Gebruiken AppNotificationManager voor nieuwe ontwikkeling.
Vergelijking van api voor meldingen
| Feature |
AppNotificationManager (Windows App SDK) |
ToastNotificationManager (WinRT) |
|---|---|---|
| Aanbevolen voor | WinUI 3, WPF, WinForms, niet-gepakte Win32 | UWP (Universal Windows Platform) |
| NuGet-pakket | Microsoft.WindowsAppSDK |
Geen (Postvak IN) |
| Pakketidentiteit vereist | Nee (kunstwerken verpakt en niet verpakt) | Vereist voor sommige functies |
| Push-integratie |
PushNotificationManager (Windows App SDK) |
WNS-kanaal-API's (Windows.Networking.PushNotifications) |
| Actieve ontwikkeling | Ja | Alleen onderhoud |
Typen meldingen
Zodra u de juiste API hebt gekozen, bepaalt u hoe uw melding wordt bezorgd:
| Typ | Beschrijving | Gebruik wanneer |
|---|---|---|
| Melding van lokale app | Rechtstreeks geactiveerd door uw app-code tijdens het uitvoeren | U wilt de gebruiker waarschuwen voor een gebeurtenis in de app |
| Gepland | Een toekomstige tijd instellen voordat de melding wordt weergegeven | Agendaherinneringen, waarschuwingen |
| Push (WNS) | Verzonden vanuit uw cloudservice via Windows Push Notification Services | Chatberichten, belangrijk nieuws, realtime updates |
| Badge | Kleine overlay op het taakbalkpictogram van de app | Aantal ongelezen, statusindicator |
Zie Een methode voor het leveren van meldingen kiezen voor een volledige uitsplitsing van de leveringsmethoden.
Volgende stappen
Bouw je een WinUI 3- of Windows App SDK-app?
-
Overzicht van app-meldingen : lokale en push-app-meldingen met behulp van
AppNotificationManager - Snelstartgids voor app-meldingen
-
Overzicht van pushmeldingen - WNS-push met behulp van
PushNotificationManager
Een WPF- of WinForms-app bouwen?
- Quickstart voor app-meldingen — lokale toastmeldingen werken verpakt of onverpakt
- Snelstartgids voor pushmeldingen: WNS-push ondersteunt een beperkt echt ongepakt pad, maar verpakking (MSIX of verpakt met externe locatieoptie) is vereist voor levering op de achtergrond en COM-activering
Belangrijk
Windows App SDK pushmeldingen vereisen een Azure-account en een Azure AD-app-registratie. Als uw app is verpakt, moet u ook een PFN-toewijzingsaanvraag (Package Family Name) per e-mail indienen. Dit kan maximaal één week duren voordat de app wordt gestart. Zie de quickstart voor pushmeldingen voor volledige vereisten.
Een UWP-app bouwen of onderhouden?
- Een lokale app-melding verzenden vanuit C++ UWP-apps
- overzicht van Windows Push Notification Services (WNS
Migreren van een UWP-app naar Windows App SDK?
Met ons samenwerken op GitHub
De bron voor deze inhoud vindt u op GitHub, waar u ook problemen en pull-aanvragen kunt maken en controleren. Bekijk onze gids voor inzenders voor meer informatie.
Windows developer