Bahasa

BackgroundTaskBuilder Kelas

Definisi

Ruang nama:
Microsoft.Windows.ApplicationModel.Background
Edit

Mewakili tugas latar belakang untuk mendaftar dengan sistem.

public ref class BackgroundTaskBuilder sealed
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackgroundTaskBuilder final
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.ApplicationModel.Background.BackgroundTaskContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BackgroundTaskBuilder
function BackgroundTaskBuilder()
Public NotInheritable Class BackgroundTaskBuilder
Warisan
Object Platform::Object IInspectable BackgroundTaskBuilder
Atribut
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Keterangan

Untuk informasi tentang memigrasikan aplikasi UWP dengan tugas latar belakang ke WinUI 3, lihat panduan strategi migrasi tugas latar belakang SDK Aplikasi Windows.

Kelas ini bukan bersifat agile, yang berarti Anda perlu mempertimbangkan model threading dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Objek Agile di C++/WinRT, Threading, dan Marshaling (C++/CX), dan Menggunakan objek Windows Runtime di lingkungan multithreaded (.NET).

Note

Secara internal, BackgroundTaskBuilder menggunakan ApplicationData.LocalSettings untuk menyimpan informasi pendaftaran tugas latar belakang, sehingga membersihkan kontainer LocalSettings dapat memengaruhi fungsi tugas latar belakang yang terdaftar sebelumnya. Untuk informasi selengkapnya tentang pengaturan lokal, lihat Menyimpan dan mengambil pengaturan dan data aplikasi lainnya.

Konstruktor

Nama Deskripsi
BackgroundTaskBuilder()

Buat objek BackgroundTaskBuilder baru.

Properti

Nama Deskripsi
Name

Mendapatkan atau mengatur nama tugas latar belakang.
TaskGroup

Mendapatkan dan mengatur pengidentifikasi grup sehingga pendaftaran tugas latar belakang dapat dipertahankan secara terpisah.

Metode

Nama Deskripsi
AddCondition(IBackgroundCondition)

Menambahkan kondisi ke tugas latar belakang.
Register()

Mendaftarkan tugas latar belakang dengan sistem.
Register(String)

Mendaftarkan tugas latar belakang dengan sistem.
SetTaskEntryPointClsid(Guid)

Menetapkan titik entri COM CLSID untuk tugas latar belakang menggunakan objek BackgroundTaskBuilder yang ada.
SetTrigger(IBackgroundTrigger)

Mengatur pemicu peristiwa untuk tugas latar belakang.

Berlaku untuk

Lihat juga