AppNotificationProgressBar.BindValue Metodo

Definizione

Spazio dei nomi:

Microsoft.Windows.AppNotifications.Builder

Associa la proprietà AppNotificationProgressBar.Value .

public:
 virtual AppNotificationProgressBar ^ BindValue() = BindValue;

AppNotificationProgressBar BindValue();

public AppNotificationProgressBar BindValue();

function bindValue()

Public Function BindValue () As AppNotificationProgressBar

Restituisce

AppNotificationProgressBar

Restituisce l'istanza di AppNotificationProgressBar in modo che sia possibile concatenare altre chiamate di metodo.

Esempio

Nell'esempio seguente viene illustrato come impostare la proprietà Value di una barra di stato di notifica dell'app usando il data binding.

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);

Payload XML risultante:

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

Aggiornare i valori associati chiamando AppNotificationManager.UpdateAsync e specificando il tag e facoltativamente il gruppo, del tag da aggiornare.

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);
}

Commenti

Il valore Value è associato per impostazione predefinita. Aggiornare il valore dello stato associato assegnando un oggetto AppNotificationProgressData alla proprietà AppNotification.Progress.

È anche possibile impostare il valore con la proprietà AppNotificationProgressBar.Value o chiamando AppNotificationProgressBar.SetValue.

Per indicazioni sull'uso delle API AppNotificationBuilder per creare l'interfaccia utente per le notifiche dell'app, vedere Contenuto di notifica dell'app.

Per informazioni di riferimento sullo schema XML per le notifiche dell'app, vedere Schema del contenuto di notifica dell'app.