Programar una app notificación

Puede programar una app notificación para que aparezca más adelante, sin importar si app se está ejecutando en ese momento. Esto es útil para escenarios como mostrar recordatorios u otras tareas de seguimiento para el usuario, donde la hora y el contenido de la notificación se conocen antes de tiempo.

Las notificaciones programadas app tienen un período de entrega de 5 minutos. Si el equipo está desactivado durante el tiempo de entrega programado y permanece apagado durante más de 5 minutos, la notificación se "quitará" como ya no es relevante para el usuario. Si necesita la entrega garantizada de notificaciones independientemente de cuánto tiempo estaba desactivado el equipo, se recomienda usar una tarea en segundo plano con un desencadenador de hora. Para obtener más información, vea Tareas en segundo plano.

Para obtener más información sobre app las notificaciones, consulte App introducción a las notificaciones.

Nota:

En los ejemplos de código de este artículo se usa el espacio de nombres para crear contenido de notificación y el espacio de nombres />

Programar la notificación

Para programar una notificación para un momento futuro, use AppNotificationBuilder para definir el contenido de la notificación, después, llame a AddToSchedule con un ScheduledToastNotification. En el ejemplo siguiente se programa una notificación para que aparezca 10 segundos a partir de ahora.

using Microsoft.Windows.AppNotifications.Builder;
using Windows.UI.Notifications;
using Windows.Data.Xml.Dom;

var payload = new AppNotificationBuilder()
    .AddArgument("action", "viewItemsDueToday")
    .AddText("ASTR 170B1")
    .AddText("You have 3 items due today!")
    .BuildNotification()
    .Payload;

var doc = new XmlDocument();
doc.LoadXml(payload);

var scheduledNotification = new ScheduledToastNotification(doc, DateTimeOffset.Now.AddSeconds(10));
scheduledNotification.Tag = "18365";
scheduledNotification.Group = "ASTR 170B1";

ToastNotificationManager.CreateToastNotifier().AddToSchedule(scheduledNotification);

Las propiedades Tag y Group actúan como una clave principal compuesta para la notificación. Establecer estos valores le permite cancelar o reemplazar la notificación programada más adelante, como se muestra en la sección siguiente.

Cancelación de notificaciones programadas

Para cancelar una notificación programada, llame a GetScheduledToastNotifications para recuperar la lista de notificaciones pendientes y, a continuación, llame a RemoveFromSchedule en el que coincida con la etiqueta especificada anteriormente.

var notifier = ToastNotificationManager.CreateToastNotifier();
var scheduled = notifier.GetScheduledToastNotifications();

foreach (var notification in scheduled)
{
    if (notification.Tag == "18365")
    {
        notifier.RemoveFromSchedule(notification);
    }
}

Consulte también

  • Last updated on