Enviar uma notificação do sistema local de um aplicativo C#

Quando o usuário clicar na notificação (ou em um botão na notificação com ativação em primeiro plano), o App.xaml.cs OnActivated do aplicativo será invocado e os argumentos adicionados serão retornados.

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

Primeiro, em seu Package.appxmanifest, adicione:

1. Declaração para xmlns:com
2. Declaração para xmlns:desktop
3. No atributo IgnorableNamespaces, com e desktop
4. desktop:Extension para windows.toastNotificationActivation para declarar o CLSID do ativador do sistema (usando um novo GUID de sua escolha).
5. Somente MSIX: com:Extension para o ativador COM usando o GUID da etapa #4. Certifique-se de incluir o Arguments="-ToastActivated" para que você saiba que seu lançamento foi de uma notificação

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>

Em seguida, no código de inicialização do aplicativo (App.xaml.cs OnStartup para WPF), assine o evento 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);
    });
};

Quando o usuário clicar em qualquer uma de suas notificações (ou em um botão na notificação), acontecerá o seguinte...

Se o seu aplicativo estiver em execução no momento...

1. O evento ToastNotificationManagerCompat.OnActivated será invocado em um thread em segundo plano.

Se o seu aplicativo estiver fechado no momento...

1. O EXE do aplicativo será iniciado e ToastNotificationManagerCompat.WasCurrentProcessToastActivated() retornará true para indicar que o processo foi iniciado devido a uma ativação moderna e que o manipulador de eventos será invocado em breve.
2. Em seguida, o evento ToastNotificationManagerCompat.OnActivated será invocado em um thread em segundo plano.

Quando o usuário clicar em qualquer uma de suas notificações (ou em um botão na notificação), acontecerá o seguinte...

Se o seu aplicativo estiver em execução no momento...

1. O evento ToastNotificationManagerCompat.OnActivated será invocado em um thread em segundo plano.

Se o seu aplicativo estiver fechado no momento...

1. O EXE do aplicativo será iniciado e ToastNotificationManagerCompat.WasCurrentProcessToastActivated() retornará true para indicar que o processo foi iniciado devido a uma ativação moderna e que o manipulador de eventos será invocado em breve.
2. Em seguida, o evento ToastNotificationManagerCompat.OnActivated será invocado em um thread em segundo plano.

No código de inicialização do aplicativo (App.xaml.cs OnStartup para WPF), assine o evento 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);
    });
};

Você não precisa fazer nada! Quando os aplicativos UWP são desinstalados, todas as notificações e quaisquer outros recursos relacionados são limpos automaticamente.

Você não precisa fazer nada! Quando os aplicativos MSIX são desinstalados, todas as notificações e quaisquer outros recursos relacionados são limpos automaticamente.

Se o aplicativo tiver um desinstalador, no desinstalador você deverá chamar ToastNotificationManagerCompat.Uninstall();. Se o aplicativo for um "aplicativo portátil" sem um instalador, considere chamar esse método na saída do aplicativo, a menos que você tenha notificações que devem persistir depois que o aplicativo for fechado.

O método de desinstalação limpará todas as notificações agendadas e atuais, removerá todos os valores do Registro associados e removerá todos os arquivos temporários associados que foram criados pela biblioteca.

Quando você especifica a ativação em segundo plano na notificação do sistema (ou em um botão dentro da notificação do sistema), sua tarefa em segundo plano será executada em vez de ativar o aplicativo em primeiro plano.

Para obter mais informações sobre tarefas em segundo plano, consulte Dar suporte ao seu aplicativo com tarefas em segundo plano.

Se você estiver direcionando o build 14393 ou posterior, poderá usar tarefas em segundo plano no processo, o que simplifica muito as coisas. Observe que as tarefas em segundo plano em processo não serão executadas em versões mais antigas do Windows. Usaremos uma tarefa em segundo plano em processo neste exemplo de código.

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

Em seguida, no App.xaml.cs, substitua o método OnBackgroundActivated. Em seguida, você pode recuperar os argumentos predefinidos e a entrada do usuário, semelhante à ativação em primeiro plano.

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

Para aplicativos da área de trabalho, as ativações em segundo plano são tratadas da mesma forma que as ativações em primeiro plano (o manipulador de eventos OnActivated será disparado). Você pode optar por não mostrar nenhuma interface do usuário e fechar seu aplicativo depois de lidar com a ativação.