AppNotificationBuilder.SetTag(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Establece el identificador de etiqueta de una notificación de aplicación.
public:
virtual AppNotificationBuilder ^ SetTag(Platform::String ^ value) = SetTag;AppNotificationBuilder SetTag(winrt::hstring const& value);public AppNotificationBuilder SetTag(string value);function setTag(value)Public Function SetTag (value As String) As AppNotificationBuilderParámetros
- value
-
String
Platform::String
winrt::hstring
Cadena que identifica la etiqueta asociada a la notificación de la aplicación.
Devoluciones
Devuelve la instancia de AppNotificationBuilder para que se puedan encadenar llamadas de método adicionales.
Ejemplos
En el ejemplo siguiente se muestra cómo establecer la etiqueta para una notificación de aplicación.
var notification = new AppNotificationBuilder()
.AddText("Notification text.")
.SetTag("Tag value")
.BuildNotification();
AppNotificationManager.Default.Show(notification);
La carga XML resultante:
<toast>
<visual>
<binding template='ToastGeneric'>
<text>Notification text.</text>
</binding>
</visual>
</toast>
Un ejemplo de cómo quitar todas las notificaciones del Centro de notificaciones por etiqueta.
await AppNotificationManager.Default.RemoveByTagAsync("Tag value");
Comentarios
Puede usar la etiqueta para quitar las notificaciones asociadas a la etiqueta del Centro de notificaciones llamando a AppNotificationManager.RemoveByTagAsync o AppNotificationManager.RemoveByTagAndGroupAsync.
Para obtener instrucciones sobre el uso de las API de AppNotificationBuilder para crear la interfaz de usuario para las notificaciones de la aplicación, consulte El contenido de la notificación de la aplicación.
Para obtener información de referencia sobre el esquema XML para las notificaciones de aplicación, consulte Esquema de contenido de notificación de aplicaciones.