BackgroundTaskCompletedEventArgs Kelas
Definisi
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.
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
- Atribut
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. |