BackgroundTaskDeferral Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Background

Rappresenta un rinvio dell'attività in background restituito dal metodo IBackgroundTaskInstance.GetDeferral .

public ref class BackgroundTaskDeferral sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BackgroundTaskDeferral final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BackgroundTaskDeferral

Public NotInheritable Class BackgroundTaskDeferral

Ereditarietà

Object Platform::Object IInspectable BackgroundTaskDeferral

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

Nell'esempio seguente viene illustrato come usare un rinvio di un'attività in background per ritardare la chiusura prematura di un'attività mentre il codice asincrono è ancora in esecuzione. Assicurarsi di completare tutti i rinvii delle attività in background. La maggior parte delle attività in background ha un timeout dopo il quale l'app verrà sospesa o terminata indipendentemente dal fatto che siano presenti rinvii in sospeso. Tuttavia, lasciando posticipi di attività in background in sospeso interferisce con la capacità del sistema di gestire le durate dei processi in modo tempestivo.

//
// Declare that your background task's Run method makes asynchronous calls by
// using the async keyword.
//
public async void Run(IBackgroundTaskInstance taskInstance)
{
    //
    // Create the deferral by requesting it from the task instance.
    //
    BackgroundTaskDeferral deferral = taskInstance.GetDeferral();

    //
    // Call asynchronous method(s) using the await keyword.
    //
    var result = await ExampleMethodAsync();

    //
    // Once the asynchronous method(s) are done, close the deferral.
    //
    deferral.Complete();
}

Metodi

Complete()

Indica al sistema che è stata completata un'operazione asincrona associata a un'attività in background.