BackgroundTaskBuilder Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.Background

Mewakili tugas latar belakang untuk mendaftar dengan sistem.

public ref class BackgroundTaskBuilder sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BackgroundTaskBuilder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BackgroundTaskBuilder

function BackgroundTaskBuilder()

Public NotInheritable Class BackgroundTaskBuilder

Warisan

Object Platform::Object IInspectable BackgroundTaskBuilder

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

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

Keterangan

Catatan

Kelas ini tidak lincah, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX) dan Menggunakan objek Windows Runtime di lingkungan multithreaded (.NET).

Jika tugas latar belakang Anda memerlukan konektivitas jaringan, ketahui hal berikut:

** Pemicu terkait jaringan**

• Gunakan SocketActivityTrigger untuk mengaktifkan tugas latar belakang saat paket diterima dan Anda perlu melakukan tugas berumur pendek. Setelah melakukan tugas, tugas latar belakang harus dihentikan untuk menghemat daya.
• Gunakan ControlChannelTrigger untuk mengaktifkan tugas latar belakang saat paket diterima dan Anda perlu melakukan tugas berumur panjang.

** Kondisi dan bendera terkait jaringan**

• Tambahkan kondisi InternetAvailable (BackgroundTaskBuilder.AddCondition) ke tugas latar belakang Anda untuk menunda pemicu tugas latar belakang hingga tumpukan jaringan berjalan. Kondisi ini menghemat daya karena tugas latar belakang tidak akan dijalankan sampai akses jaringan tersedia. Kondisi ini tidak memberikan aktivasi real-time.

Terlepas dari pemicu yang Anda gunakan, atur IsNetworkRequested pada tugas latar belakang Anda untuk memastikan bahwa jaringan tetap aktif saat tugas latar belakang berjalan. Ini memberi tahu infrastruktur tugas latar belakang untuk menjaga jaringan tetap aktif saat tugas dijalankan, bahkan jika perangkat telah memasuki mode Siaga Tersambung. Jika tugas latar belakang Anda tidak menggunakan IsNetworkRequested, maka tugas latar belakang Anda tidak akan dapat mengakses jaringan ketika dalam mode Siaga Tersambung (misalnya, ketika layar telepon dimatikan.)

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1703	15063	Grup Tugas
2004	19041	SetTaskEntryPointClsid

Konstruktor

BackgroundTaskBuilder()

Membuat instans kelas BackgroundTaskBuilder .

Properti

AllowRunningTaskInStandby	Mewakili tugas latar belakang untuk mendaftar dengan sistem.
CancelOnConditionLoss	Menunjukkan apakah tugas latar belakang akan dibatalkan jika setidaknya salah satu kondisi yang diperlukan tidak lagi terpenuhi.
IsNetworkRequested	Menunjukkan apakah akan menjaga jaringan tetap aktif saat menjalankan tugas latar belakang.
IsRunningTaskInStandbySupported	Mewakili tugas latar belakang untuk mendaftar dengan sistem.
Name	Mendapatkan atau mengatur nama tugas latar belakang.
TaskEntryPoint	Mendapatkan atau mengatur kelas yang melakukan pekerjaan tugas latar belakang.
TaskGroup	Mendapatkan dan mengatur pengidentifikasi grup.

Metode

AddCondition(IBackgroundCondition)	Menambahkan kondisi ke tugas latar belakang.
Register()	Mendaftarkan tugas latar belakang dengan sistem.
Register(String)	Mewakili tugas latar belakang untuk mendaftar dengan sistem.
SetTaskEntryPointClsid(Guid)	Menetapkan titik entri COM CLSID menggunakan objek BackgroundTaskBuilder yang ada.
SetTrigger(IBackgroundTrigger)	Mengatur pemicu peristiwa untuk tugas latar belakang.
Validate()	Mewakili tugas latar belakang untuk mendaftar dengan sistem.