BackgroundTaskDeferral Classe

Definição

Namespace:

Windows.ApplicationModel.Background

Representa um adiamento de tarefa em segundo plano retornado pelo método 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

Herança

Object Platform::Object IInspectable BackgroundTaskDeferral

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo a seguir mostra como usar um adiamento de tarefa em segundo plano para atrasar o fechamento prematuro de uma tarefa enquanto o código assíncrono ainda está em execução. Certifique-se de concluir todos os adiamentos de tarefas em segundo plano. A maioria das tarefas em segundo plano tem um tempo limite após o qual o aplicativo será suspenso ou encerrado, independentemente de haver algum adiamento pendente. No entanto, deixar adiamentos de tarefas em segundo plano pendentes interfere na capacidade do sistema de gerenciar tempos de vida do processo em tempo hábilidade.

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

Métodos

Complete()

Informa ao sistema que uma operação assíncrona associada a uma tarefa em segundo plano foi concluída.