Compartir a través de

AppNotificationProgressBar.BindValue Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.Windows.AppNotifications.Builder
Editar

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 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 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 Value está enlazado de forma predeterminada. Actualice el valor de estado enlazado asignando un objeto AppNotificationProgressData a la propiedad AppNotification.Progress.

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

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.

Se aplica a