AppNotificationBuilder.SetTag(String) Metodo

Definizione

Spazio dei nomi:

Microsoft.Windows.AppNotifications.Builder

Imposta l'identificatore di tag per una notifica dell'app.

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 AppNotificationBuilder

Parametri

value

String

Platform::String

winrt::hstring

Stringa che identifica il tag associato alla notifica dell'app.

Restituisce

AppNotificationBuilder

Restituisce il 'istanza di AppNotificationBuilder in modo che sia possibile concatenare altre chiamate al metodo.

Esempio

L'esempio seguente illustra l'impostazione del tag per una notifica dell'app.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetTag("Tag value")
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Payload XML risultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
</toast>

Esempio di rimozione di tutte le notifiche dal Centro notifiche in base al tag.

await AppNotificationManager.Default.RemoveByTagAsync("Tag value");

Commenti

È possibile usare il tag per rimuovere le notifiche associate al tag dal Centro notifiche chiamando AppNotificationManager.RemoveByTagAsync o AppNotificationManager.RemoveByTagAndGroupAsync.

Per indicazioni sull'uso delle API di AppNotificationBuilder per creare l'interfaccia utente per le notifiche dell'app, vedere contenuto di notifica dell'app.

Per informazioni di riferimento su XML Schema per le notifiche delle app, vedere Schema del contenuto di notifica dell'app.