Bagikan melalui


BackgroundTaskBuilder Kelas

Definisi

Mewakili tugas latar belakang untuk mendaftar dengan sistem.

public ref class BackgroundTaskBuilder sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class BackgroundTaskBuilder final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class BackgroundTaskBuilder
[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

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.

Berlaku untuk