WebUIBackgroundTaskInstance.Current Properti

Definisi

Ruang nama:

Windows.UI.WebUI

Mendapatkan tugas latar belakang saat ini.

public:
 static property IWebUIBackgroundTaskInstance ^ Current { IWebUIBackgroundTaskInstance ^ get(); };

static IWebUIBackgroundTaskInstance Current();

public static IWebUIBackgroundTaskInstance Current { get; }

var iWebUIBackgroundTaskInstance = WebUIBackgroundTaskInstance.current;

Public Shared ReadOnly Property Current As IWebUIBackgroundTaskInstance

Nilai Properti

IWebUIBackgroundTaskInstance

Tugas latar belakang saat ini. Properti ini hanya dapat diakses dalam konteks tugas latar belakang. Properti ini null dalam aplikasi latar depan.

Keterangan

Aplikasi membuat tugas latar belakang dengan menggunakan kelas BackgroundTaskBuilder . Metode SetTrigger harus diatur ke pemicu peristiwa untuk tugas tersebut. TaskEntryPoint harus menentukan file JavaScript yang berisi kode yang akan dijalankan. Aplikasi kemudian mendaftarkan tugas latar belakang dengan memanggil metode Register . Ketika pemicu diaktifkan, sistem menjalankan kode dalam file JavaScript.

Aplikasi juga harus menentukan file JavaScript di bagian <Extensions> manifes aplikasi. Misalnya: <Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">..

Saat tugas latar belakang dijalankan, tugas dapat menggunakan objek yang dikembalikan dari properti Saat Ini untuk mengatur keberhasilan atau kegagalan tugas latar belakang dan untuk mengakses properti tugas.

Setelah tugas latar belakang menyelesaikan pekerjaannya, tugas harus memanggil metode dekat Pekerja Web untuk mengakhiri dirinya sendiri. Dengan cara ini tidak terus mengonsumsi memori dan baterai pengguna. Selain itu, hanya satu tugas latar belakang untuk pemicu yang sama yang dapat berjalan pada satu waktu sehingga tugas sebelumnya harus ditutup sebelum tugas baru dapat dipicu.

Catatan

Tugas latar belakang dimaksudkan untuk menjadi tugas berumur pendek. Secara umum, Anda tidak boleh mendaftar untuk panggilan balik peristiwa dalam tugas latar belakang. Jika Anda mendaftar untuk peristiwa Windows Runtime dan instans latar depan aplikasi Anda juga mendaftar untuk peristiwa tersebut, panggilan balik di tugas latar belakang Anda mungkin tidak dapat diandalkan.