Lenguaje

ToastNotificationManager Clase

Definición

Espacio de nombres:
Windows.UI.Notifications
Editar

Crea objetos ToastNotifier que se usan para generar notificaciones del sistema. Esta clase también proporciona acceso al contenido XML de las plantillas del sistema proporcionadas por el sistema para que pueda personalizar ese contenido para usarlo en las notificaciones.

public ref class ToastNotificationManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ToastNotificationManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotificationManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public static class ToastNotificationManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class ToastNotificationManager
Public Class ToastNotificationManager
Herencia
Object Platform::Object IInspectable ToastNotificationManager
Atributos
ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Requisitos Description
Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo siguiente se muestra cómo crear y enviar una notificación del sistema que incluya texto e imágenes, incluido el uso de los métodos GetTemplateContent y CreateToastNotifier .

// The GetTemplateContent method returns a Windows.Data.Xml.Dom.XmlDocument object
// that contains the toast notification XML content.
var toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastImageAndText01);

// You can use the methods from the XML document to specify the required elements for the toast.
var images = toastXml.GetElementsByTagName("image");
images[0].Attributes.Where( a => a.LocalName.ToString() == "src").First().NodeValue = "images/toastImageAndText.png";

var textNodes = toastXml.GetElementsByTagName("text");
for(var index = 0; index < textNodes.Count; index++) 
{
    var text = $"Text element {index}. ";
    textNodes[index].AppendChild(toastXml.CreateTextNode(text));
};

// Create a toast notification from the XML, then create a ToastNotifier object
// to send the toast.

var toast = new ToastNotification(toastXml);

ToastNotificationManager.CreateToastNotifier().Show(toast);

Comentarios

Envío de notificaciones del sistema desde aplicaciones de escritorio

Por lo general, el envío de una notificación del sistema desde una aplicación de escritorio es el mismo que el envío desde una aplicación para UWP. Sin embargo, debe tener en cuenta estas diferencias y requisitos:

  • Para que una aplicación de escritorio muestre una notificación del sistema, la aplicación debe tener un acceso directo en la pantalla Inicio.
  • El acceso directo debe tener un AppUserModelID.
  • Las aplicaciones de escritorio no pueden programar una notificación del sistema.

Para obtener más información, consulte estos temas:

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1607 14393 ConfigureNotificationMirroring
1607 14393 GetForUser
1703 15063 GetDefault

Propiedades

Nombre Description
History

Obtiene el objeto ToastNotificationHistory .

Métodos

Nombre Description
ConfigureNotificationMirroring(NotificationMirroring)

Especifica si se permite la creación de reflejo de notificaciones. La creación de reflejo de notificaciones permite difundir una notificación en varios dispositivos.
CreateToastNotifier()

Crea e inicializa una nueva instancia de ToastNotifier, enlazada a la aplicación que realiza la llamada, que permite generar una notificación del sistema a esa aplicación.
CreateToastNotifier(String)

Crea e inicializa una nueva instancia de ToastNotifier, enlazada a una aplicación especificada, normalmente otra aplicación del mismo paquete.
GetDefault()

Obtiene un administrador de notificaciones del sistema para el usuario actual.
GetForUser(User)

Obtiene un administrador de notificaciones del sistema para el usuario especificado.
GetTemplateContent(ToastTemplateType)

Obtiene el contenido XML de una de las plantillas de notificación del sistema predefinidas para que pueda personalizarlo para usarlo en la notificación.

Se aplica a

Consulte también