AppNotificationProgressBar.BindValue Méthode

Référence

Définition

Espace de noms:: Microsoft.Windows.AppNotifications.Builder

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Lie la propriété AppNotificationProgressBar.Value .

public:
 virtual AppNotificationProgressBar ^ BindValue() = BindValue;

AppNotificationProgressBar BindValue();

public AppNotificationProgressBar BindValue();

function bindValue()

Public Function BindValue () As AppNotificationProgressBar

Retours

AppNotificationProgressBar

Retourne le instance AppNotificationProgressBar afin que des appels de méthode supplémentaires puissent être chaînés.

Exemples

L’exemple suivant montre comment définir la propriété Value d’une barre de progression de notification d’application à l’aide de la liaison de données.

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

Charge utile XML résultante :

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

Mettez à jour les valeurs liées en appelant AppNotificationManager.UpdateAsync et en spécifiant la balise, et éventuellement le groupe, de la balise que vous souhaitez mettre à jour.

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

Remarques

La valeur Value est liée par défaut. Mettez à jour la valeur status liée en affectant un objet AppNotificationProgressData à la propriété AppNotification.Progress.

Vous pouvez également définir la valeur avec la propriété AppNotificationProgressBar.Value ou en appelant AppNotificationProgressBar.SetValue.

Pour obtenir des conseils sur l’utilisation des API AppNotificationBuilder pour créer l’interface utilisateur pour les notifications d’application, consultez Contenu des notifications d’application.

Pour obtenir des informations de référence sur le schéma XML pour les notifications d’application, consultez Schéma de contenu de notification d’application.

S’applique à

Partager via