다음을 통해 공유


BackgroundTaskCompletedEventArgs 클래스

정의

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

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

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합니다.

적용 대상