AppNotificationProgressBar.BindValue Método

Definición

Espacio de nombres:

Microsoft.Windows.AppNotifications.Builder

Enlaza la propiedad AppNotificationProgressBar.Value.

public:
 virtual AppNotificationProgressBar ^ BindValue() = BindValue;

AppNotificationProgressBar BindValue();

public AppNotificationProgressBar BindValue();

function bindValue()

Public Function BindValue () As AppNotificationProgressBar

Devoluciones

AppNotificationProgressBar

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

Ejemplos

En el ejemplo siguiente se muestra cómo establecer la propiedad Value de una barra de progreso de notificación de la 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

El valor Valor está enlazado de forma predeterminada. Actualice el valor de estado enlazado asignando un objeto AppNotificationProgressData al objeto AppNotification.Progresss.

También puede establecer el valor con la propiedad AppNotificationProgressBar.Value o llamando a AppNotificationProgressBar.SetValue.

Para obtener instrucciones sobre cómo usar las API de AppNotificationBuilder para crear la interfaz de usuario para las notificaciones de la aplicación, consulte contenido de notificación de 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 aplicación.