BackgroundTaskCompletedEventArgs Kelas

Referensi

Definisi

Ruang nama:: Windows.ApplicationModel.Background

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mewakili informasi penyelesaian untuk tugas pada saat pemberitahuan penyelesaian dikirim.

public ref class BackgroundTaskCompletedEventArgs 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 BackgroundTaskCompletedEventArgs 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 BackgroundTaskCompletedEventArgs

Public NotInheritable Class BackgroundTaskCompletedEventArgs

Warisan: Object Platform::Object IInspectable BackgroundTaskCompletedEventArgs

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh berikut menunjukkan cara menggunakan kelas BackgroundTaskCompletedEventArgs dengan delegasi BackgroundTaskCompletedEventHandler untuk memantau penyelesaian tugas latar belakang saat aplikasi berada di latar depan. Perhatikan bahwa ini tergantung pada tugas latar belakang untuk melaporkan status melalui LocalSettings.

private async void OnCompleted(IBackgroundTaskRegistration task,
                               BackgroundTaskCompletedEventArgs args)
{
    var settings = ApplicationData.Current.LocalSettings;
    var key = task.TaskId.ToString();
    string status = settings.Values[key].ToString();

    //
    // UI element updates should be done asynchronously.
    //
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
    () =>
    {
        ExampleProgressElement.Text = "Task completed with status: " + status;
    });
}

Keterangan

Sistem menghasilkan kelas ini dan meneruskannya sebagai argumen ke handler BackgroundTaskCompletedEventHandler aplikasi.

Properti

InstanceId

Mendapatkan pengidentifikasi instans tugas latar belakang untuk pemberitahuan status penyelesaian ini.

Metode

CheckResult()

Memberikan pengecualian jika tugas latar belakang yang selesai telah melaporkan kesalahan.

Berlaku untuk

Bagikan melalui