BackgroundTaskProgressEventArgs Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.ApplicationModel.Background

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta le informazioni sullo stato di avanzamento per un'attività al momento dell'invio di una notifica di aggiornamento dello stato.

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

Ereditarietà: Object Platform::Object IInspectable BackgroundTaskProgressEventArgs

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene illustrato come usare la classe BackgroundTaskProgressEventArgs con un delegato BackgroundTaskProgressEventHandler per visualizzare lo stato dell'attività in background mentre l'app è in primo piano.

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

Commenti

Il sistema genera questa classe e lo passa come argomento al gestore BackgroundTaskProgressEventHandler dell'applicazione.

Proprietà

InstanceId	Ottiene l'identificatore dell'istanza dell'attività in background per la notifica dello stato di avanzamento.
Progress	Ottiene lo stato di avanzamento per un'istanza dell'attività in background.

Si applica a

Condividi tramite