Senden einer lokalen Popupbenachrichtigung aus einer C#-App

Wenn der Benutzer auf Ihre Benachrichtigung klickt (oder auf eine Schaltfläche auf der Benachrichtigung mit Vordergrundaktivierung), wird die App.xaml.cs OnActivated 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
    }
}

Fügen Sie zunächst in Ihrem Package.appxmanifest Folgendes hinzu:

1. Deklaration für xmlns:com
2. Deklaration für xmlns:desktop
3. Im Attribut IgnorableNamespaces, com und Desktop
4. desktop:Extension for windows.toastNotificationActivation to declare your toast activator CLSID (using a new GUID of your choice).
5. MSIX only: com:Extension for the COM activator using the GUID from step #4. Achten Sie darauf, dass Sie wissen Arguments="-ToastActivated" , dass Ihr Start über eine Benachrichtigung stammt.

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 derzeit ausgeführt wird...

1. Das ToastNotificationManagerCompat.OnActivated-Ereignis wird in einem Hintergrundthread aufgerufen.

Wenn Ihre App derzeit geschlossen ist...

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

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

Wenn Ihre App derzeit ausgeführt wird...

1. Das ToastNotificationManagerCompat.OnActivated-Ereignis wird in einem Hintergrundthread aufgerufen.

Wenn Ihre App derzeit geschlossen ist...

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

Abonnieren Sie 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);
    });
};

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

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

Wenn Ihre App über einen Deinstallationsprogramm verfügt, sollten Sie in Ihrem Deinstallationsprogramm aufrufen ToastNotificationManagerCompat.Uninstall();. 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.

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

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

Wenn Sie auf Build 14393 oder höher abzielen, können Sie Hintergrundaufgaben in Prozessen 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 In-Process-Hintergrundaufgabe.

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 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();
}

Bei Desktopanwendungen werden Hintergrundaktivierungen genauso behandelt wie Vordergrundaktivierungen (Der OnActivated-Ereignishandler wird ausgelöst). Sie können auswählen, dass nach der Aktivierung keine Benutzeroberfläche angezeigt und die App geschlossen wird.