BackgroundTaskCompletedEventArgs 클래스

정의

네임스페이스:

Windows.ApplicationModel.Background

완료 알림이 전송될 때 작업에 대한 완료 정보를 나타냅니다.

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

상속

Object Platform::Object IInspectable BackgroundTaskCompletedEventArgs

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

예제

다음 예제에서는 BackgroundTaskCompletedEventArgs 클래스를 BackgroundTaskCompletedEventHandler 대리자와 함께 사용하여 앱이 포그라운드에 있는 동안 백그라운드 작업 완료를 모니터링하는 방법을 보여줍니다. 이는 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;
    });
}

설명

시스템은 이 클래스를 생성하여 애플리케이션의 BackgroundTaskCompletedEventHandler 처리기에 인수로 전달합니다.

속성

InstanceId

이 완료 상태 알림에 대한 백그라운드 작업 instance 식별자를 가져옵니다.

메서드

CheckResult()

백그라운드 작업 완료 이벤트가 오류를 보고한 경우 예외를 throw합니다.