Senden einer lokalen App-Benachrichtigung aus einer C#-App

Zuerst fügen Sie in Ihrer Package.appxmanifestFolgendes hinzu:

1. Deklaration für xmlns:com
2. Deklaration für xmlns:desktop
3. Im Attribut IgnorableNamespacescom und Desktop
4. desktop:Extension für windows.toastNotificationActivation, um die CLSID Ihres Toast-Benachrichtigungsaktivators zu deklarieren (mithilfe einer neuen GUID Ihrer Wahl).
5. Nur MSIX: com:Extension für den COM-Aktivator unter Verwendung der GUID aus Schritt #4. Achten Sie darauf, die Arguments="-ToastActivated" beizufügen, damit Sie wissen, dass Ihr Start über eine Benachrichtigung erfolgt.

Package.appxmanifest

<!--Add these namespaces-->
<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 toast clicked-->
        <desktop:Extension Category="windows.toastNotificationActivation">
          <desktop:ToastNotificationActivation ToastActivatorCLSID="replaced-with-your-guid-C173E6ADF0C3" /> 
        </desktop:Extension>

        <!--Register COM CLSID LocalServer32 registry key-->
        <com:Extension Category="windows.comServer">
          <com:ComServer>
            <com:ExeServer Executable="YourProject\YourProject.exe" Arguments="-ToastActivated" DisplayName="Toast activator">
              <com:Class Id="replaced-with-your-guid-C173E6ADF0C3" DisplayName="Toast activator"/>
            </com:ExeServer>
          </com:ComServer>
        </com:Extension>

      </Extensions>
    </Application>
  </Applications>
 </Package>

Abonnieren Sie dann im Startcode Ihrer App (App.xaml.cs OnStartup für WPF) das OnActivated-Ereignis.

// Listen to notification activation
ToastNotificationManagerCompat.OnActivated += toastArgs =>
{
    // Obtain the arguments from the notification
    ToastArguments args = ToastArguments.Parse(toastArgs.Argument);

    // Obtain any user input (text boxes, menu selections) from the notification
    ValueSet userInput = toastArgs.UserInput;

    // Need to dispatch to UI thread if performing UI operations
    Application.Current.Dispatcher.Invoke(delegate
    {
        // TODO: Show the corresponding content
        MessageBox.Show("Toast activated. Args: " + toastArgs.Argument);
    });
};

Wenn der Benutzer auf eine Ihrer Benachrichtigungen klickt (oder eine Schaltfläche auf der Benachrichtigung), geschieht Folgendes...

Wenn Ihre App derzeitausgeführt wird...

1. Das ToastNotificationManagerCompat.OnActivated-Ereignis wird in einem Hintergrund-Thread ausgelöst.

Wenn Ihre App derzeit geschlossen ist,...

1. Die EXE Ihrer App wird gestartet und ToastNotificationManagerCompat.WasCurrentProcessToastActivated() gibt "true" zurück, um anzugeben, dass der Prozess aufgrund einer modernen Aktivierung gestartet wurde und der Ereignishandler bald aufgerufen wird.
2. Anschließend wird das Ereignis ToastNotificationManagerCompat.OnActivated in einem Hintergrundthread aufgerufen.

Wenn der Benutzer auf eine Ihrer Benachrichtigungen klickt (oder eine Schaltfläche auf der Benachrichtigung), geschieht Folgendes...

Wenn Ihre App derzeitausgeführt wird...

1. Das ToastNotificationManagerCompat.OnActivated-Ereignis wird in einem Hintergrund-Thread ausgelöst.

Wenn Ihre App derzeit geschlossen ist,...

1. Die EXE Ihrer App wird gestartet und ToastNotificationManagerCompat.WasCurrentProcessToastActivated() gibt "true" zurück, um anzugeben, dass der Prozess aufgrund einer modernen Aktivierung gestartet wurde und der Ereignishandler bald aufgerufen wird.
2. Anschließend wird das Ereignis ToastNotificationManagerCompat.OnActivated in einem Hintergrundthread aufgerufen.

Im Startcode Ihrer App (App.xaml.cs OnStartup für WPF) abonnieren Sie das OnActivated-Ereignis.

// Listen to notification activation
ToastNotificationManagerCompat.OnActivated += toastArgs =>
{
    // Obtain the arguments from the notification
    ToastArguments args = ToastArguments.Parse(toastArgs.Argument);

    // Obtain any user input (text boxes, menu selections) from the notification
    ValueSet userInput = toastArgs.UserInput;

    // Need to dispatch to UI thread if performing UI operations
    Application.Current.Dispatcher.Invoke(delegate
    {
        // TODO: Show the corresponding content
        MessageBox.Show("Toast activated. Args: " + toastArgs.Argument);
    });
};

Wenn der Benutzer auf Ihre Benachrichtigung klickt (oder auf eine Schaltfläche mit Vordergrundaktivierung innerhalb der Benachrichtigung), wird die App.xaml.csOnActivated in Ihrer App aufgerufen, und die hinzugefügten Argumente werden zurückgegeben.

App.xaml.cs

protected override void OnActivated(IActivatedEventArgs e)
{
    // Handle notification activation
    if (e is ToastNotificationActivatedEventArgs toastActivationArgs)
    {
        // Obtain the arguments from the notification
        ToastArguments args = ToastArguments.Parse(toastActivationArgs.Argument);

        // Obtain any user input (text boxes, menu selections) from the notification
        ValueSet userInput = toastActivationArgs.UserInput;
 
        // TODO: Show the corresponding content
    }
}

Sie müssen nichts tun! Wenn MSIX-Apps deinstalliert werden, werden alle Benachrichtigungen und alle anderen zugehörigen Ressourcen automatisch bereinigt.

Wenn Ihre App ein Deinstallationsprogramm hat, sollten Sie darin ToastNotificationManagerCompat.Uninstall();aufrufen. Wenn Ihre App eine "portable App" ohne Installationsprogramm ist, sollten Sie diese Methode beim Beenden der App aufrufen, es sei denn, Sie haben Benachrichtigungen, die nach dem Schließen der App beibehalten werden sollen.

Mit der Deinstallationsmethode werden alle geplanten und aktuellen Benachrichtigungen bereinigt, alle zugehörigen Registrierungswerte entfernt und alle zugehörigen temporären Dateien entfernt, die von der Bibliothek erstellt wurden.

Sie müssen nichts tun! Wenn UWP-Apps deinstalliert werden, werden alle Benachrichtigungen und alle anderen zugehörigen Ressourcen automatisch bereinigt.

Bei Desktopanwendungen werden Hintergrundaktivitäten genauso behandelt wie Vordergrundaktivitäten (Ihr OnActivated Ereignishandler wird ausgelöst). Sie können auswählen, die Benutzeroberfläche nicht anzuzeigen und Ihre App nach der Aktivierung zu schließen.

Wenn Sie die Hintergrundaktivierung für Die App-Benachrichtigung (oder auf einer Schaltfläche innerhalb der Benachrichtigung) angeben, wird die Hintergrundaufgabe ausgeführt, anstatt die Vordergrund-App zu aktivieren.

Weitere Informationen zu Hintergrundaufgaben finden Sie unter Unterstützen Sie Ihre App mit Hintergrundaufgaben.

Wenn Sie auf Build 14393 oder höher abzielen, können Sie In-Prozess-Hintergrundaufgaben verwenden, die die Dinge erheblich vereinfachen. Beachten Sie, dass In-Process-Hintergrundaufgaben bei älteren Versionen von Windows nicht ausgeführt werden können. In diesem Codebeispiel verwenden wir eine Hintergrundaufgabe im Prozess.

const string taskName = "ToastBackgroundTask";

// If background task is already registered, do nothing
if (BackgroundTaskRegistration.AllTasks.Any(i => i.Value.Name.Equals(taskName)))
    return;

// Otherwise request access
BackgroundAccessStatus status = await BackgroundExecutionManager.RequestAccessAsync();

// Create the background task
BackgroundTaskBuilder builder = new BackgroundTaskBuilder()
{
    Name = taskName
};

// Assign the toast action trigger
builder.SetTrigger(new ToastNotificationActionTrigger());

// And register the task
BackgroundTaskRegistration registration = builder.Register();

Überschreiben Sie dann in Ihrem App.xaml.cs die OnBackgroundActivated-Methode. Anschließend können Sie die vordefinierten Argumente und Benutzereingaben abrufen, ähnlich wie bei der Vordergrundaktivierung.

App.xaml.cs

protected override async void OnBackgroundActivated(BackgroundActivatedEventArgs args)
{
    var deferral = args.TaskInstance.GetDeferral();
 
    switch (args.TaskInstance.Task.Name)
    {
        case "ToastBackgroundTask":
            var details = args.TaskInstance.TriggerDetails as ToastNotificationActionTriggerDetail;
            if (details != null)
            {
                ToastArguments arguments = ToastArguments.Parse(details.Argument);
                var userInput = details.UserInput;

                // Perform tasks
            }
            break;
    }
 
    deferral.Complete();
}