Używanie powiadomień aplikacji w aplikacjach .NET

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.

Zrzut ekranu przedstawiający powiadomienie aplikacji

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

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.