BackgroundTaskCompletedEventArgs Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.ApplicationModel.Background

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Share via