BackgroundTaskCompletedEventArgs Class

Représente les informations d'achèvement d'une tâche lorsqu'une notification d'achèvement est envoyée.

Syntaxe


/* Pour plus d'informations sur la création ou l'accès à cet objet, consultez les notes. */

Attributs

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Membres

BackgroundTaskCompletedEventArgsClasse possède ces types de membres :

Méthodes

The BackgroundTaskCompletedEventArgs Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
CheckResult Throws an exception if the background task completed event has reported an error.

 

Propriétés

Le BackgroundTaskCompletedEventArgsClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

InstanceId

En lecture seuleGets the identifier of the background task instance for this completion status notification.

 

Remarques

Le système génère cette classe et la passe en tant qu'argument au gestionnaire BackgroundTaskCompletedEventHandler de l'application.

Exemples

L'exemple suivant montre comment utiliser la classe BackgroundTaskCompletedEventArgs avec un délégué BackgroundTaskCompletedEventHandler pour surveiller l'achèvement des tâches en arrière-plan pendant que l'application est au premier plan. Notez que cela dépend de la tâche en arrière-plan de signaler l'état via LocalSettings.


private async void OnCompleted(IBackgroundTaskRegistration task,
                               BackgroundTaskCompletedEventArgs args)
{
    var settings = ApplicationData.Current.LocalSettings;
    var key = task.TaskId.ToString();
    string status = settings.Values[key].ToString();

    //
    // UI element updates should be done asynchronously.
    //
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
    () =>
    {
        ExampleProgressElement.Text = "Task completed with status: " + status;
    });
}

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.ApplicationModel.Background
Windows::ApplicationModel::Background [C++]

Métadonnées

Windows.winmd

 

 

Afficher:
© 2014 Microsoft. Tous droits réservés.