BackgroundTaskCompletedEventArgs Classe

Definizione

Rappresenta le informazioni di completamento per un'attività al momento dell'invio di una notifica di completamento.

public ref class BackgroundTaskCompletedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackgroundTaskCompletedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BackgroundTaskCompletedEventArgs
Public NotInheritable Class BackgroundTaskCompletedEventArgs
Ereditarietà
Object Platform::Object IInspectable BackgroundTaskCompletedEventArgs
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio seguente mostra come usare la classe BackgroundTaskCompletedEventArgs con un delegato BackgroundTaskCompletedEventHandler per monitorare il completamento delle attività in background mentre l'app è in primo piano. Si noti che questo dipende dall'attività in background per segnalare lo stato tramite 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;
    });
}

Commenti

Il sistema genera questa classe e la passa come argomento al gestore BackgroundTaskCompletedEventHandler dell'applicazione.

Proprietà

InstanceId

Ottiene l'identificatore dell'istanza dell'attività in background per questa notifica dello stato di completamento.

Metodi

CheckResult()

Genera un'eccezione se l'evento di completamento dell'attività in background ha segnalato un errore.

Si applica a