AppNotificationProgressBar.BindStatus Método

Definición

Espacio de nombres:

Microsoft.Windows.AppNotifications.Builder

Enlaza la propiedad AppNotificationProgressBar.Status.

public:
 virtual AppNotificationProgressBar ^ BindStatus() = BindStatus;

AppNotificationProgressBar BindStatus();

public AppNotificationProgressBar BindStatus();

function bindStatus()

Public Function BindStatus () 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 Estado 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 estado de está enlazado de forma predeterminada. Actualice el valor de estado enlazado asignando un objeto AppNotificationProgressData al objeto AppNotification.Progresss.

También puede establecer el estado con la propiedad AppNotificationProgressBar.Status o llamando a AppNotificationProgressBar.SetStatus.

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.