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	Возвращает идентификатор экземпляра фоновой задачи для уведомления о состоянии выполнения.
Progress	Возвращает состояние хода выполнения для экземпляра фоновой задачи.