BackgroundTaskDeferral 클래스

정의

네임스페이스:

Windows.ApplicationModel.Background

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

상속

Object Platform::Object IInspectable BackgroundTaskDeferral

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

다음 예제에서는 비동기 코드가 계속 실행되는 동안 백그라운드 작업 지연을 사용하여 작업이 조기에 닫히는 것을 지연하는 방법을 보여 주며, 모든 백그라운드 작업 지연을 완료해야 합니다. 대부분의 백그라운드 작업에는 보류 중인 지연이 있는지 여부에 관계없이 앱이 일시 중단되거나 종료되는 시간 제한이 있습니다. 그러나 미해결 백그라운드 작업 지연을 남기면 시스템이 프로세스 수명을 적시에 관리하는 기능을 방해합니다.

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

메서드

Complete()

백그라운드 작업과 연결된 비동기 작업이 완료되었음을 시스템에 알릴 수 있습니다.