Udostępnij za pośrednictwem


Omówienie powiadomień systemu Windows

System Windows udostępnia kilka interfejsów API powiadomień w różnych generacjach zestawu SDK. Jeśli szukasz w trybie online sposobu wysyłania powiadomienia i znajdowania przykładów powodujących konflikt, ta strona pomoże Ci wybrać odpowiedni interfejs API dla aplikacji.

Którego interfejsu API należy użyć?

Odpowiedź zależy od tego, który zestaw SDK jest przeznaczony dla twojej aplikacji:

Typ aplikacji Zalecany interfejs API Namespace
WinUI 3 / Zestaw SDK aplikacji systemu Windows (nowe aplikacje) AppNotificationManager Microsoft.Windows.AppNotifications
WPF, WinForms lub nieopakowany Win32 AppNotificationManager za pośrednictwem narzędzia NuGet Microsoft.Windows.AppNotifications
Platforma UWP (istniejące aplikacje, brak planowanej migracji) ToastNotificationManager Windows.UI.Notifications

Ważna

Większość odpowiedzi na Stack Overflow i starszych samouczków używa przestrzeni nazw Windows.UI.NotificationsToastNotificationManager. Jest to interfejs API WinRT platformy UWP. Działa w aplikacjach UWP i może działać w niektórych scenariuszach desktopowych, ale nie jest to zalecana ścieżka dla nowych aplikacji Windows App SDK. Użyj AppNotificationManager do nowych opracowań.

Porównanie interfejsu API powiadomień

Funkcja AppNotificationManager (Zestaw SDK aplikacji systemu Windows) ToastNotificationManager (WinRT)
Zalecane dla WinUI 3, WPF, WinForms, rozpakowany Win32 platforma UWP
Pakiet NuGet Microsoft.WindowsAppSDK Brak wiadomości (skrzynka odbiorcza)
Wymagana tożsamość pakietu Nie (działają w stanie zapakowanym i rozpakowanym) Wymagane dla niektórych funkcji
Integracja push PushNotificationManager (Zestaw SDK aplikacji systemu Windows) Interfejsy API kanału WNS (Windows.Networking.PushNotifications)
Aktywne programowanie Yes Tylko konserwacja

Typy powiadomień

Po wybraniu odpowiedniego interfejsu API zdecyduj, jak powiadomienie zostanie dostarczone:

Typ Opis Użyj, gdy
Powiadomienie o aplikacji lokalnej Wyzwalane bezpośrednio przez kod aplikacji podczas uruchamiania Chcesz powiadomić użytkownika o zdarzeniu w aplikacji
Scheduled Ustawianie przyszłego czasu wyświetlania powiadomienia Przypomnienia kalendarza, alarmy
Powiadomienie push (WNS) Wysłane z usługi w chmurze za pomocą Windows Push Notification Services Wiadomości czatu, aktualności, aktualizacje w czasie rzeczywistym
Odznaka Mała nakładka na ikonę paska zadań aplikacji Liczba nieprzeczytanych elementów, wskaźnik stanu

Aby uzyskać pełny podział metod dostarczania, zobacz Wybieranie metody dostarczania powiadomień.

Następne kroki

Tworzenie aplikacji WinUI 3 lub Zestawu SDK aplikacji systemu Windows?

Czy tworzysz lub utrzymujesz aplikację platformy UWP?

Migrowanie aplikacji platformy UWP do zestawu SDK aplikacji systemu Windows?