AppNotificationProgressBar.BindValueStringOverride Método

Definición

Espacio de nombres:

Microsoft.Windows.AppNotifications.Builder

Enlaza la propiedad AppNotificationProgressBar.ValueStringOverride .

public:
 virtual AppNotificationProgressBar ^ BindValueStringOverride() = BindValueStringOverride;

AppNotificationProgressBar BindValueStringOverride();

public AppNotificationProgressBar BindValueStringOverride();

function bindValueStringOverride()

Public Function BindValueStringOverride () As AppNotificationProgressBar

Devoluciones

AppNotificationProgressBar

Devuelve la instancia appNotificationProgressBar para que se puedan encadenar llamadas de método adicionales.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer la propiedad ValueStringOverride de una barra de progreso de notificación de aplicación mediante el enlace de datos.

var notification = new AppNotificationBuilder()
    .AddText("Downloading your weekly playlist...")
    .AddProgressBar(new AppNotificationProgressBar()
        .BindTitle()
        .BindStatus()
        .BindValue()
        .BindValueStringOverride())
        .SetTag(tagName)
        .SetGroup(groupName))
    .BuildNotification();

var data = new AppNotificationProgressData (sequenceNumber /* Sequence number */);
data.Title = "Retreiving files"; // Binds to {progressTitle} in xml payload
data.Value = (double) currentFile / totalFiles; // Binds to {progressValue} in xml payload
data.ValueStringOverride = String.Format("{0}/{1} files", currentFile, totalFiles); // Binds to {progressValueString} in xml payload
data.Status = "Downloading..."; // Binds to {progressStatus} in xml payload

notification.Progress = data;

AppNotificationManager.Default.Show(notification);

La carga XML resultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Downloading your weekly playlist...</text>
            <progress title='{progressTitle}' status='{progressStatus}' value='{progressValue}' valueStringOverride='{progressValueString}'/>
        </binding>
    </visual>
</toast>

Actualice los valores enlazados llamando a AppNotificationManager.UpdateAsync y especificando la etiqueta, y opcionalmente el grupo, de la etiqueta que desea actualizar.

private async Task UpdateProgressBar()
{
    var data = new AppNotificationProgressData(sequenceNumber /* Sequence number */);
    data.Title = "Retreiving files"; // Binds to {progressTitle} in xml payload
    data.Value = (double)currentFile / totalFiles; // Binds to {progressValue} in xml payload
    data.ValueStringOverride = String.Format("{0}/{1} files", currentFile, totalFiles); // Binds to {progressValueString} in xml payload
    data.Status = (currentFile < totalFiles) ? "Downloading..." : "Complete!"; // Binds to {progressStatus} in xml payload

    await AppNotificationManager.Default.UpdateAsync(data, tagName, groupName);
}

Comentarios

Actualice el valor de título enlazado asignando un objeto AppNotificationProgressData a la propiedad AppNotification.Progress.

También puede establecer el título con la propiedad AppNotificationProgressBar.Title o llamando a AppNotificationProgressBar.SetValueStringOverride.

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 Contenido de la notificación de la aplicación.

Para obtener información de referencia sobre el esquema XML para las notificaciones de aplicaciones, consulte Esquema de contenido de notificación de aplicaciones.