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 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

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

메서드

CheckResult()

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