Envoyer une notification toast locale à partir d’une application C#

Lorsque l’utilisateur clique sur votre notification (ou un bouton sur la notification avec activation de premier plan), le App.xaml.cs OnActivated de votre application est appelé et les arguments que vous avez ajoutés sont retournés.

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
    }
}

Tout d’abord, dans votre Package.appxmanifest, ajoutez :

1. Déclaration pour xmlns:com
2. Déclaration pour xmlns:desktop
3. Dans l'attribut IgnorableNamespaces, com et desktop
4. desktop :Extension pour windows.toastNotificationActivation pour déclarer votre CLSID d’activateur toast (à l’aide d’un nouveau GUID de votre choix).
5. MSIX uniquement : com :Extension pour l’activateur COM à l’aide du GUID de l’étape 4. Veillez à inclure l’élément Arguments="-ToastActivated" afin que vous sachiez que votre lancement provient d’une notification

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>

Ensuite, dans le code de démarrage de votre application (App.xaml.cs OnStartup pour WPF), abonnez-vous à l’événement OnActivated.

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

Lorsque l’utilisateur clique sur l’une de vos notifications (ou un bouton sur la notification), la commande suivante se produit...

Si votre application est en cours d’exécution...

1. L’événement ToastNotificationManagerCompat.OnActivated est appelé sur un thread d’arrière-plan.

Si votre application est actuellement fermée...

1. L’exe de votre application sera lancé et ToastNotificationManagerCompat.WasCurrentProcessToastActivated() retournera true pour indiquer que le processus a été démarré en raison d’une activation moderne et que le gestionnaire d’événements sera bientôt appelé.
2. Ensuite, l’événement ToastNotificationManagerCompat.OnActivated est appelé sur un thread d’arrière-plan.

Lorsque l’utilisateur clique sur l’une de vos notifications (ou un bouton sur la notification), la commande suivante se produit...

Si votre application est en cours d’exécution...

1. L’événement ToastNotificationManagerCompat.OnActivated est appelé sur un thread d’arrière-plan.

Si votre application est actuellement fermée...

1. L’exe de votre application sera lancé et ToastNotificationManagerCompat.WasCurrentProcessToastActivated() retournera true pour indiquer que le processus a été démarré en raison d’une activation moderne et que le gestionnaire d’événements sera bientôt appelé.
2. Ensuite, l’événement ToastNotificationManagerCompat.OnActivated est appelé sur un thread d’arrière-plan.

Dans le code de démarrage de votre application (App.xaml.cs OnStartup pour WPF), abonnez-vous à l’événement OnActivated.

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

Tu n’as rien à faire ! Lorsque les applications UWP sont désinstallées, toutes les notifications et toutes les autres ressources associées sont automatiquement nettoyées.

Tu n’as rien à faire ! Lorsque les applications MSIX sont désinstallées, toutes les notifications et toutes les autres ressources associées sont automatiquement nettoyées.

Si votre application dispose d’un programme de désinstallation, dans votre programme de désinstallation, vous devez appeler ToastNotificationManagerCompat.Uninstall();. Si votre application est une « application portable » sans programme d’installation, envisagez d’appeler cette méthode lors de la sortie de l’application, sauf si vous avez des notifications destinées à persister une fois votre application fermée.

La méthode de désinstallation nettoie toutes les notifications planifiées et actuelles, supprime toutes les valeurs de Registre associées et supprime les fichiers temporaires associés créés par la bibliothèque.

Lorsque vous spécifiez l’activation en arrière-plan sur votre toast (ou sur un bouton à l’intérieur du toast), votre tâche en arrière-plan est exécutée au lieu d’activer votre application de premier plan.

Pour plus d’informations sur les tâches en arrière-plan, consultez Prendre en charge votre application avec des tâches en arrière-plan.

Si vous ciblez la build 14393 ou une version ultérieure, vous pouvez utiliser des tâches en arrière-plan in-process, ce qui simplifie considérablement les choses. Notez que les tâches en arrière-plan en cours ne s’exécutent pas sur les versions antérieures de Windows. Nous allons utiliser une tâche en arrière-plan in-process dans cet exemple de code.

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

Ensuite, dans votre App.xaml.cs, remplacez la méthode OnBackgroundActivated. Vous pouvez ensuite récupérer les arguments prédéfinis et les entrées utilisateur, similaires à l’activation au premier plan.

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

Pour les applications de bureau, les activations en arrière-plan sont gérées de la même façon que les activations au premier plan (votre gestionnaire d’événements OnActivated sera déclenché). Vous pouvez choisir de ne pas afficher l’interface utilisateur et de fermer votre application après avoir géré l’activation.