BackgroundTaskProgressEventArgs 클래스

정의

네임스페이스:

Windows.ApplicationModel.Background

진행률 업데이트 알림이 전송되는 시점에 작업에 대한 진행률 정보를 나타냅니다.

public ref class BackgroundTaskProgressEventArgs 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 BackgroundTaskProgressEventArgs 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 BackgroundTaskProgressEventArgs

Public NotInheritable Class BackgroundTaskProgressEventArgs

상속

Object IInspectable BackgroundTaskProgressEventArgs

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

예제

다음 예제에서는 앱이 포그라운드에 있는 동안 BackgroundTaskProgressEventArgs 클래스를 대리자에서 BackgroundTaskProgressEventHandler 사용하여 백그라운드 작업 진행률을 표시하는 방법을 보여줍니다.

private async void OnProgress(IBackgroundTaskRegistration task, BackgroundTaskProgressEventArgs args)
{
    //
    // UI element updates should be done asynchronously.
    //
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
    () =>
    {
        ExampleProgressElement.Text = "Progress is at " args.Progress + "%.";
    });
}

설명

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

속성

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