Windows bildirimlerine genel bakış

Windows, farklı SDK nesillerinde çeşitli bildirim API'leri sağlar. Çevrimiçi ortamda bildirim gönderme ve çakışan örnekler bulma konusunda arama yaparsanız, bu sayfa uygulamanız için doğru API'yi seçmenize yardımcı olur.

Hangi API'i kullanmalıyım?

Yanıt, uygulamanızın hedeflediği SDK'ya bağlıdır:

Uygulama türü	Önerilen API	Namespace
WinUI 3 / Windows Uygulama SDK'sı (yeni uygulamalar)	AppNotificationManager	Microsoft.Windows.AppNotifications
WPF, WinForms veya paketlenmemiş Win32	AppNotificationManager NuGet aracılığıyla	Microsoft.Windows.AppNotifications
UWP (mevcut uygulamalar, geçiş planlı değil)	ToastNotificationManager	Windows.UI.Notifications

Önemli

Stack Overflow yanıtlarının ve eski öğreticilerin çoğu, ToastNotificationManager ad alanından Windows.UI.Notifications kullanır. Bu , UWP WinRT API'dir. UWP uygulamalarında çalışır ve bazı masaüstü senaryolarında çalışabilir, ancak yeni Windows Uygulama SDK'sı uygulamaları için önerilen yol değildir. Yeni geliştirme için kullanın AppNotificationManager .

Bildirimler API'sini karşılaştırma

Özellik	AppNotificationManager (Windows Uygulama SDK'sı)	ToastNotificationManager (WinRT)
için önerilir	WinUI 3, WPF, WinForms, paketlenmemiş Win32	Evrensel Windows Platformu (UWP)
NuGet paketi	Microsoft.WindowsAppSDK	Hiçbiri (gelen kutusu)
Paket kimliği gerekiyor	Hayır (paketlenmiş ve paketlenmemiş olarak çalışır)	Bazı özellikler için gereklidir
Anında iletme tümleştirmesi	PushNotificationManager (Windows Uygulama SDK'sı)	WNS kanal API'leri (Windows.Networking.PushNotifications)
Etkin geliştirme	Evet	Yalnızca bakım

Bildirim türleri

Doğru API'yi seçtikten sonra bildiriminizin nasıl teslim edileceğine karar verin:

Türü	Açıklama	Şu durumlarda kullanın:
Yerel uygulama bildirimi	Çalışırken uygulama kodunuz tarafından doğrudan tetiklenen	Kullanıcıyı uygulama içi bir olayla ilgili uyarmak istiyorsunuz
Scheduled	Bildirimin görünmesi için gelecek bir saat ayarlama	Takvim anımsatıcıları, alarmlar
Anında Bildirim (WNS)	Windows Anında İletme Bildirimi Hizmetleri aracılığıyla bulut hizmetinizden gönderilir	Sohbet mesajları, son dakika haberleri, gerçek zamanlı güncelleştirmeler
Rozet	Uygulamanın görev çubuğundaki küçük katman simgesi	Okunmamış sayısı ve durum göstergesi

Teslim yöntemlerinin tam dökümü için bkz. Bildirim teslim yöntemi seçme.

Sonraki Adımlar

WinUI 3 veya Windows Uygulama SDK'sı uygulaması oluşturma?

• Uygulama bildirimlerine genel bakış — yerel ve anlık bildirimler uygulaması kullanarak AppNotificationManager
• Uygulama bildirimleri başlangıç kılavuzu
• Anında iletme bildirimlerine genel bakış — WNS push using PushNotificationManager

WPF veya WinForms uygulaması oluşturma?

• Uygulama bildirimleri için hızlı başlangıç — yerel toast bildirimleri paketlenmiş veya paketlenmemiş olarak çalışabilir.
• Anında iletme bildirimleri hızlı başlangıç kılavuzu — WNS gönderimi, sınırlı bir biçimde paketlenmemiş yolları destekler, ancak arka plan teslimi ve COM etkinleştirmesi için paketleme (MSIX veya harici bir konumla paketlenmiş) gereklidir.

Önemli

Windows Uygulama SDK'sı anında iletme bildirimleri için bir Azure hesabı ve bir Microsoft Entra ID uygulama kaydı gerekir. Uygulamanız paketlenmişse, e-postayla bir Paket Aile Adı (PFN) eşleme isteği de göndermeniz gerekir; başlatmadan önce bir haftaya kadar işleme süresine izin verin. Tüm önkoşullar için anında ilet bildirimleri hızlı başlangıç kılavuzuna bakın.

UWP uygulaması oluşturma veya sürdürme

• C++ UWP uygulamalarından yerel uygulama bildirimi gönderme
• Windows Anında İletme Bildirimi Hizmetlerine (WNS) genel bakış

UWP uygulamasını Windows Uygulama SDK'sı?

• Anlık bildirimleri taşıma
• Anında iletme bildirimlerini taşıma