Uso de notificaciones de aplicaciones con una aplicación WinForms

Una notificación de aplicación es un elemento emergente de la interfaz de usuario que aparece fuera de la ventana de la aplicación, lo que proporciona información oportuna o acciones al usuario. Las notificaciones pueden ser puramente informativas, pueden iniciar la aplicación cuando se hace clic o pueden desencadenar una acción en segundo plano sin llevar la aplicación al primer plano.

Captura de pantalla de una notificación de aplicación

Este artículo le guía por los pasos para crear y enviar una notificación de aplicación desde una aplicación WinForms y, a continuación, controlar la activación cuando el usuario interactúa con ella. En este artículo se usan las API de SDK de Aplicaciones para WindowsMicrosoft.Windows.AppNotifications.

Para obtener información general sobre las notificaciones de aplicaciones y las instrucciones de otros marcos, consulte Introducción a las notificaciones de aplicaciones.

En este artículo se tratan las notificaciones locales. Para obtener información sobre cómo entregar notificaciones desde un servicio en la nube, consulte Notificaciones push.

Importante

Actualmente no se admiten las notificaciones de aplicaciones con privilegios elevados (administradores).

Prerrequisitos

Configura tu proyecto

En el archivo del proyecto (.csproj), asegúrese de que el TargetFramework incluye una plataforma de destino de Windows:

<TargetFramework>net9.0-windows10.0.19041.0</TargetFramework>

Agregue el paquete NuGet SDK de Aplicaciones para Windows:

<PackageReference Include="Microsoft.WindowsAppSDK" Version="1.7.250310001" />

En el caso de las aplicaciones sin empaquetar, agregue:

<WindowsPackageType>None</WindowsPackageType>

Registro para notificaciones de aplicaciones

En Program.cs, regístrese para recibir notificaciones antes de llamar a Application.Run(). Debe registrar el controlador NotificationInvoked antes de llamar a Register.

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".
        });
    }
}

Nota:

En el caso de las aplicaciones sin empaquetar, Register() configura automáticamente el registro del servidor COM que permite que Windows inicie la aplicación cuando se hace clic en una notificación. No es necesario configurar manualmente la activación COM ni un AUMID.

Envío de una notificación de aplicación

Use AppNotificationBuilder para construir contenido de notificación y AppNotificationManager.Show para enviar una notificación desde el formulario.

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

Para obtener información sobre cómo agregar botones, imágenes, entradas y otro contenido enriquecido a las notificaciones, consulte Contenido de notificación de la aplicación.

Configuración de la aplicación empaquetada

En el caso de las aplicaciones WinForms sin empaquetar, Register() controla automáticamente el registro COM. Para las aplicaciones empaquetadas (MSIX), debe agregar extensiones a su Package.appxmanifest. Consulte Configuración de la aplicación empaquetada en el artículo de WPF para las entradas necesarias del manifiesto.

Contenido relacionado

  • Last updated on