Windows értesítések áttekintése

Windows számos értesítési API-t biztosít a különböző SDK-generációkban. Ha online keresi, hogyan küldhet értesítést, és ütköző példákat talál, ez a lap segít kiválasztani az alkalmazáshoz megfelelő API-t.

Melyik API-t használjam?

A válasz attól függ, hogy az alkalmazás melyik SDK-t célozza meg:

Alkalmazás típusa	Ajánlott API	Namespace
WinUI 3/ Windows App SDK (új alkalmazások)	AppNotificationManager	Microsoft.Windows.AppNotifications
WPF, WinForms vagy csomagolatlan Win32	AppNotificationManager NuGeten keresztül	Microsoft.Windows.AppNotifications
UWP (meglévő alkalmazások, nincs tervezett migrálás)	ToastNotificationManager	Windows.UI.Notifications

Fontos

A legtöbb Stack Overflow-válasz és a régi oktatóanyagok ToastNotificationManager használják a Windows.UI.Notifications névtérből. Ez az UWP WinRT API. UWP-alkalmazásokban működik, és bizonyos asztali forgatókönyvekben is működhet, de nem ez az új Windows App SDK-alkalmazások ajánlott elérési útja. Új fejlesztéshez használható AppNotificationManager .

Értesítések API-összehasonlítása

Funkció	AppNotificationManager (Windows App SDK)	ToastNotificationManager (WinRT)
Ajánlott a következőhöz:	WinUI 3, WPF, WinForms, csomagolatlan Win32	UWP
NuGet-csomag	Microsoft.WindowsAppSDK	Nincs (beérkezett üzenetek)
Csomagazonosító szükséges	Nem (csomagolt és csomagolatlan munka)	Egyes funkciókhoz szükséges
Push integráció	PushNotificationManager (Windows App SDK)	WNS-csatorna API-k (Windows.Networking.PushNotifications)
Aktív fejlesztés	Igen	Csak karbantartás

Az értesítések típusai

Miután kiválasztotta a megfelelő API-t, döntse el az értesítés kézbesítésének módját:

Típus	Leírás	Használat:
Helyi alkalmazásértesítés	Közvetlenül az alkalmazáskód aktiválja futás közben	Riasztást szeretne küldeni a felhasználónak egy alkalmazáson belüli eseményről
Scheduled	Az értesítés megjelenésének jövőbeli időpontjának beállítása	Naptáremlékeztetők, riasztások
Leküldés (WNS)	A felhőszolgáltatásból küldve Windows Push értesítési szolgáltatásokon keresztül.	Csevegőüzenetek, friss hírek, valós idejű frissítések
Jelvény	Kis átfedés az alkalmazás tálcaikonján	Olvasatlanok száma, állapotjelző

A kézbesítési módok teljes lebontásához lásd: Értesítési kézbesítési módszer kiválasztása.

Következő lépések

WinUI 3- vagy Windows App SDK-alkalmazás létrehozása?

• Alkalmazásértesítések áttekintése – helyi és push értesítések a AppNotificationManager
• Alkalmazásértesítések – gyors kezdő útmutató
• Push értesítések áttekintése – WNS push használata PushNotificationManager

WPF vagy WinForms-alkalmazás létrehozása?

• Alkalmazásértesítések gyorsindítása – a helyi toast értesítések csomagolt vagy csomagolatlan formában is működnek
• Push értesítések gyors indítás – A WNS push korlátozottan támogatja a valóban csomagolatlan útvonalat, de a háttérkézbesítéshez és a COM-aktiváláshoz csomagolásra (MSIX vagy külső hellyel csomagolt) van szükség.

Fontos

Windows App SDK leküldéses értesítésekhez Azure fiók és Azure AD-alkalmazásregisztráció szükséges. Ha az alkalmazás csomagolva van, e-mailben is be kell küldenie egy PFN-leképezési kérelmet – engedélyezzen legfeljebb egy hét feldolgozási időt az indítás előtt. A teljes előfeltételeket a leküldéses értesítések gyorsútmutatója tartalmazza.

UWP-alkalmazás létrehozása vagy karbantartása?

• Helyi alkalmazásértesítés küldése C++ UWP-alkalmazásokból
• Windows Leküldéses értesítési szolgáltatások (WNS) áttekintése

UWP-alkalmazást migrál a Windows App SDK-ra?

• Felugró értesítések migrálása
• Leküldéses értesítések migrálása