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 Platform::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	이 진행률 상태 알림에 대한 백그라운드 작업 instance 식별자를 가져옵니다.
Progress	백그라운드 작업 instance 대한 진행률 상태 가져옵니다.