Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Powiadomienie aplikacji to wyskakujące okienko interfejsu użytkownika, które pojawia się poza oknem aplikacji, dostarczając użytkownikowi terminowe informacje lub akcje. Powiadomienia mogą być wyłącznie informacyjne, można uruchamiać aplikację po kliknięciu lub wyzwalać akcję w tle bez przełączania aplikacji na pierwszy plan.
W tym artykule opisano kroki tworzenia i wysyłania powiadomienia aplikacji z aplikacji .NET, a następnie obsługi aktywacji, gdy użytkownik wchodzi z nią w interakcję. W tym artykule użyto interfejsów API Zestaw SDK do aplikacji systemu WindowsMicrosoft.Windows.AppNotifications.
Aby zapoznać się z omówieniem powiadomień aplikacji i wskazówek dotyczących innych platform, zobacz Omówienie powiadomień aplikacji.
W tym artykule opisano powiadomienia lokalne. Aby uzyskać informacje o dostarczaniu powiadomień z usługi w chmurze, zobacz Powiadomienia push.
Important
Powiadomienia dotyczące aplikacji z podwyższonym poziomem uprawnień (administrator) nie są obecnie obsługiwane.
Wymagania wstępne
- Projekt aplikacji WPF lub WinForms przeznaczony dla .NET 6 lub nowszych.
- Należy skonfigurować projekt tak, aby:
Rejestrowanie w celu otrzymywania powiadomień o aplikacji
W App.xaml.cs zarejestruj się, aby otrzymywać powiadomienia w obsłudze zdarzeń Startup. Należy zarejestrować program obsługi NotificationInvokedzanim wywoła się Register.
Najpierw zaktualizuj App.xaml, aby używać Startup jako program obsługi zdarzeń zamiast StartupUri.
App.xaml
<Application x:Class="WpfNotifications.App"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Startup="OnStartup">
</Application>
Następnie zaimplementuj logikę uruchamiania i obsługi powiadomień:
App.xaml.cs
using System.Windows;
using Microsoft.Windows.AppNotifications;
namespace WpfNotifications;
public partial class App : Application
{
private void OnStartup(object sender, StartupEventArgs e)
{
// Register the notification handler before calling Register
AppNotificationManager.Default.NotificationInvoked += OnNotificationInvoked;
AppNotificationManager.Default.Register();
// Show the main window
var mainWindow = new MainWindow();
mainWindow.Show();
}
private void OnNotificationInvoked(
AppNotificationManager sender,
AppNotificationActivatedEventArgs args)
{
// NotificationInvoked is raised on a background thread,
// so dispatch to the UI thread for any UI updates
Current.Dispatcher.Invoke(() =>
{
// Parse args.Argument to determine what action to take.
// args.Argument contains the arguments from the notification
// or button that was clicked, as key=value pairs separated
// by '&', for example "action=reply&conversationId=9813".
});
}
protected override void OnExit(ExitEventArgs e)
{
AppNotificationManager.Default.Unregister();
base.OnExit(e);
}
}
W Program.cs zarejestruj się, aby otrzymywać powiadomienia przed wywołaniem Application.Run(). Przed wywołaniem Register należy zarejestrować program obsługi NotificationInvoked.
Program.cs
using Microsoft.Windows.AppNotifications;
namespace WinFormsNotifications;
static class Program
{
[STAThread]
static void Main()
{
// Register the notification handler before calling Register
AppNotificationManager.Default.NotificationInvoked += OnNotificationInvoked;
AppNotificationManager.Default.Register();
ApplicationConfiguration.Initialize();
Application.Run(new Form1());
// Unregister when the app exits
AppNotificationManager.Default.Unregister();
}
private static void OnNotificationInvoked(
AppNotificationManager sender,
AppNotificationActivatedEventArgs args)
{
// NotificationInvoked is raised on a background thread,
// so use Control.Invoke to marshal to the UI thread
var form = Application.OpenForms.Count > 0
? Application.OpenForms[0] as Form1
: null;
form?.Invoke(() =>
{
// Parse args.Argument to determine what action to take.
// args.Argument contains the arguments from the notification
// or button that was clicked, as key=value pairs separated
// by '&', for example "action=reply&conversationId=9813".
});
}
}
Important
Musisz wywołać Register przed wywołaniem AppInstance.GetCurrent().GetActivatedEventArgs(). Obsługa NotificationInvoked musi zostać zarejestrowana przed wywołaniem Register().
Note
Dla aplikacji bez opakowania Register() automatycznie konfiguruje rejestrację serwera COM, która umożliwia systemowi Windows uruchomienie aplikacji po kliknięciu powiadomienia. Nie musisz ręcznie konfigurować aktywacji COM ani identyfikatora AUMID.
Wysyłanie powiadomienia aplikacji
Użyj appNotificationBuilder , aby skonstruować zawartość powiadomień i AppNotificationManager.Show , aby wysłać powiadomienie.
MainWindow.xaml.cs
Form1.cs
using Microsoft.Windows.AppNotifications;
using Microsoft.Windows.AppNotifications.Builder;
private void SendNotification()
{
var notification = new AppNotificationBuilder()
.AddArgument("action", "viewConversation")
.AddArgument("conversationId", "9813")
.AddText("Andrew sent you a picture")
.AddText("Check this out, The Enchantments in Washington!")
.BuildNotification();
AppNotificationManager.Default.Show(notification);
}
Aby uzyskać informacje na temat dodawania przycisków, obrazów, danych wejściowych i innej zawartości wzbogaconej do powiadomień, zobacz Zawartość powiadomień aplikacji.
Konfiguracja spakowanej aplikacji
W przypadku nieopakowanych aplikacji .NET Register() automatycznie dokonuje rejestracji COM. W przypadku spakowanych aplikacji (MSIX) należy dodać następujące rozszerzenia do pliku Package.appxmanifest:
<Package
xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
IgnorableNamespaces="... com desktop">
<Applications>
<Application>
<Extensions>
<!--Specify which CLSID to activate when notification is clicked-->
<desktop:Extension Category="windows.toastNotificationActivation">
<desktop:ToastNotificationActivation
ToastActivatorCLSID="YOUR-GUID-HERE" />
</desktop:Extension>
<!--Register COM CLSID-->
<com:Extension Category="windows.comServer">
<com:ComServer>
<com:ExeServer
Executable="YourApp.exe"
Arguments="----AppNotificationActivated:"
DisplayName="YourApp">
<com:Class Id="YOUR-GUID-HERE" />
</com:ExeServer>
</com:ComServer>
</com:Extension>
</Extensions>
</Application>
</Applications>
</Package>
Important
Atrybut Executable powinien zawierać tylko nazwę pliku wykonywalnego (na przykład YourApp.exe), a nie ścieżkę podkatalogu.