AppNotificationProgressBar.BindValue Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Enlaza la propiedad AppNotificationProgressBar.Value .
public:
virtual AppNotificationProgressBar ^ BindValue() = BindValue;
AppNotificationProgressBar BindValue();
public AppNotificationProgressBar BindValue();
function bindValue()
Public Function BindValue () As AppNotificationProgressBar
Devoluciones
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.