BackgroundTaskBuilder.Register Metode

Definisi

Ruang nama:

Windows.ApplicationModel.Background

Overload

Register()	Mendaftarkan tugas latar belakang dengan sistem.
Register(String)

Register()

Mendaftarkan tugas latar belakang dengan sistem.

public:
 virtual BackgroundTaskRegistration ^ Register() = Register;

BackgroundTaskRegistration Register();

public BackgroundTaskRegistration Register();

function register()

Public Function Register () As BackgroundTaskRegistration

Mengembalikan

BackgroundTaskRegistration

Instans objek BackgroundTaskRegistration .

Contoh

Sampel BackgroundTask

Keterangan

Tugas harus memiliki pemicu peristiwa agar metode Register berhasil. Sistem menjadwalkan tugas latar belakang ketika peristiwa pemicunya terjadi dan semua kondisinya telah terpenuhi.

Tugas latar belakang di luar proses juga harus menentukan titik entri tugas. Lihat Membuat dan mendaftarkan tugas latar belakang dalam proses dan Membuat dan mendaftarkan tugas latar belakang di luar proses untuk detail tentang mendaftarkan setiap jenis tugas.

Validasi parameter tugas latar belakang

Windows 8 Windows 8 tidak memvalidasi parameter yang ditetapkan pada objek BackgroundTaskBuilder hingga sistem mencoba menjalankan tugas latar belakang. Jika parameter tidak valid, tugas latar belakang tidak dapat dimulai dan entri log peristiwa dibuat.

Windows 8.1 Mulai Windows 8.1, parameter yang digunakan untuk mendaftarkan tugas latar belakang divalidasi pada saat pendaftaran. Kesalahan dikembalikan jika pendaftaran tugas latar belakang gagal, memungkinkan aplikasi untuk menentukan apakah tugas latar belakang valid atau tidak. Untuk C# dan Visual Basic, kesalahan pendaftaran tugas biasanya mengakibatkan pengecualian .NET tertentu dilemparkan. Pengecualian ini dilemparkan sebagai pengecualian kesempatan pertama dan harus diperbairah saat Anda masih mengembangkan kode Anda. Aplikasi Windows 8 yang ada yang berjalan di Windows 8.1 tunduk pada perilaku sistem baru ini, yang dapat menyebabkan aplikasi mengalami crash jika tidak dapat menangani pendaftaran tugas latar belakang yang gagal. (Entri log peristiwa masih akan dibuat untuk pendaftaran tugas latar belakang yang gagal.) Akibatnya, Windows 8 aplikasi yang mendaftarkan tugas latar belakang yang tidak valid harus ditulis ulang untuk mendaftarkan tugas latar belakang dengan benar dan untuk menangani pendaftaran tugas latar belakang yang gagal sebagai pengecualian yang tertangkap.

Register(String)

public:
 virtual BackgroundTaskRegistration ^ Register(Platform::String ^ taskName) = Register;

/// [Windows.Foundation.Metadata.Experimental]
BackgroundTaskRegistration Register(winrt::hstring const& taskName);

[Windows.Foundation.Metadata.Experimental]
public BackgroundTaskRegistration Register(string taskName);

function register(taskName)

Public Function Register (taskName As String) As BackgroundTaskRegistration

Parameter

taskName

String

Platform::String

winrt::hstring

Mengembalikan

BackgroundTaskRegistration

Atribut

ExperimentalAttribute