Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O Windows fornece várias APIs de notificações ao longo de diferentes gerações de SDK. Se está a pesquisar online sobre como enviar uma notificação e a encontrar exemplos contraditórios, esta página vai ajudá-lo a escolher a API certa para a sua aplicação.
Que API devo usar?
A resposta depende do SDK que a sua aplicação pretende:
| Tipo de aplicativo | API recomendada | Namespace |
|---|---|---|
| WinUI 3 / Windows App SDK (novas aplicações) | AppNotificationManager |
Microsoft.Windows.AppNotifications |
| WPF, WinForms ou Win32 não embalado |
AppNotificationManager via NuGet |
Microsoft.Windows.AppNotifications |
| UWP (aplicações existentes, sem migração planeada) | ToastNotificationManager |
Windows.UI.Notifications |
Importante
A maioria das respostas do Stack Overflow e dos tutoriais antigos usam ToastNotificationManager do Windows.UI.Notifications namespace. Esta é a API UWP do WinRT. Funciona em aplicações UWP e pode funcionar em alguns cenários de ambiente de trabalho, mas não é o caminho recomendado para novas aplicações do Windows App SDK. Use AppNotificationManager para novos desenvolvimentos.
Comparação de APIs de notificações
| Feature |
AppNotificationManager (SDK da aplicação Windows) |
ToastNotificationManager (WinRT) |
|---|---|---|
| Recomendado para | WinUI 3, WPF, WinForms, Win32 não empacotado | UWP |
| Pacote NuGet | Microsoft.WindowsAppSDK |
Nenhum (caixa de entrada) |
| Identidade do pacote necessária | Não (obras empacotadas e desempacotadas) | Necessária para algumas funcionalidades |
| Integração push |
PushNotificationManager (SDK da aplicação Windows) |
APIs de canais WNS (Windows.Networking.PushNotifications) |
| Desenvolvimento ativo | Sim | Apenas manutenção |
Tipos de notificações
Depois de escolher a API certa, decida como a sua notificação será entregue:
| Tipo | Descrição | Utilizar quando |
|---|---|---|
| Notificação de aplicação local | Desencadeado diretamente pelo código da tua aplicação enquanto está a correr | Quer alertar o utilizador sobre um evento dentro da aplicação |
| Agendado | Defina uma hora futura para a notificação aparecer | Lembretes do calendário, alarmes |
| Empurrar (WNS) | Enviado a partir do seu serviço cloud através dos Serviços de Notificações Push do Windows | Mensagens de chat, notícias de última hora, atualizações em tempo real |
| Distintivo | Pequena sobreposição no ícone da barra de tarefas da aplicação | Contagem não lida, indicador de estado |
Para uma análise completa dos métodos de entrega, consulte Escolher um método de entrega de notificações.
Passos seguintes
Está a construir uma aplicação WinUI 3 ou Windows App SDK?
-
Visão geral das notificações da aplicação — notificações locais e push usando
AppNotificationManager - Notificações de início rápido da aplicação
-
Visão geral das notificações push — WNS push usando
PushNotificationManager
Construir ou manter uma aplicação UWP?
- Envie uma notificação de aplicação local a partir de aplicações UWP em C++
- Visão geral dos Serviços de Notificação por Push do Windows (WNS)
Migrar uma aplicação UWP para o Windows App SDK?
Colabore connosco no GitHub
A origem deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever problemas e pedidos Pull. Para mais informações, consulte o nosso guia do contribuidor.
Windows developer