AppNotificationProgressBar.BindValue Método

Definição

Namespace:

Microsoft.Windows.AppNotifications.Builder

Associa a propriedade AppNotificationProgressBar.Value.

public:
 virtual AppNotificationProgressBar ^ BindValue() = BindValue;

AppNotificationProgressBar BindValue();

public AppNotificationProgressBar BindValue();

function bindValue()

Public Function BindValue () As AppNotificationProgressBar

Retornos

AppNotificationProgressBar

Retorna a instância AppNotificationProgressBar para que chamadas de método adicionais possam ser encadeadas.

Exemplos

O exemplo a seguir ilustra como definir a propriedade Value de uma barra de progresso de notificação de aplicativo usando a associação de dados.

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

O conteúdo 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>

Atualize os valores associados chamando AppNotificationManager.UpdateAsync e especificando a marca e, opcionalmente, o grupo, da marca que você deseja atualizar.

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

Comentários

O valor de valor é associado por padrão. Atualize o valor de status associado atribuindo um objeto AppNotificationProgressData à propriedade AppNotification.Progress.

Você também pode definir o valor com a propriedade AppNotificationProgressBar.Value ou chamando AppNotificationProgressBar.SetValue.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte conteúdo de notificação do aplicativo.

Para obter informações de referência sobre o esquema XML para notificações de aplicativo, consulte esquema de conteúdo de notificação do aplicativo.