BackgroundTaskProgressEventArgs Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Background

Representa la información de progreso de una tarea en el momento en que se envía una notificación de actualización de progreso.

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

Herencia

Object Platform::Object IInspectable BackgroundTaskProgressEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo siguiente se muestra cómo usar la clase BackgroundTaskProgressEventArgs con un delegado BackgroundTaskProgressEventHandler para mostrar el progreso de la tarea en segundo plano mientras la aplicación está en primer plano.

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 + "%.";
    });
}

Comentarios

El sistema genera esta clase y la pasa como argumento al controlador BackgroundTaskProgressEventHandler de la aplicación.

Propiedades

InstanceId	Obtiene el identificador de la instancia de tarea en segundo plano para esta notificación de estado de progreso.
Progress	Obtiene el estado de progreso de una instancia de tarea en segundo plano.