BackgroundTaskProgressEventArgs Classe

Definição

Namespace:

Windows.ApplicationModel.Background

Representa informações de progresso para uma tarefa no momento em que uma notificação de atualização de progresso é enviada.

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

Herança

Object Platform::Object IInspectable BackgroundTaskProgressEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo a seguir mostra como usar a classe BackgroundTaskProgressEventArgs com um delegado BackgroundTaskProgressEventHandler para mostrar o progresso da tarefa em segundo plano enquanto o aplicativo está em primeiro 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 + "%.";
    });
}

Comentários

O sistema gera essa classe e a passa como um argumento para o manipulador BackgroundTaskProgressEventHandler do aplicativo.

Propriedades

InstanceId	Obtém o identificador da instância de tarefa em segundo plano para esse progresso status notificação.
Progress	Obtém status de progresso para uma instância de tarefa em segundo plano.