Bagikan melalui

BackgroundTransferCompletionGroup Kelas

  • Referensi

Definisi

Ruang nama:
Windows.Networking.BackgroundTransfer
Edit

Mewakili serangkaian operasi transfer latar belakang (objek DownloadOperation atau UploadOperation ) yang memicu tugas latar belakang setelah semua operasi selesai (jika operasi berhasil diselesaikan) atau gagal dengan kesalahan.

public ref class BackgroundTransferCompletionGroup 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.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackgroundTransferCompletionGroup final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BackgroundTransferCompletionGroup 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.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BackgroundTransferCompletionGroup
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BackgroundTransferCompletionGroup
function BackgroundTransferCompletionGroup()
Public NotInheritable Class BackgroundTransferCompletionGroup
Warisan
Object Platform::Object IInspectable BackgroundTransferCompletionGroup
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

Kelas BackgroundTransferCompletionGroup memungkinkan aplikasi untuk mendaftar untuk menerima pemberitahuan langsung setelah operasi transfer latar belakang selesai bahkan jika aplikasi tidak berada di latar depan. Aplikasi ini mendaftarkan tugas latar belakang untuk menerima pemberitahuan yang terjadi jika transfer latar belakang berhasil diselesaikan atau jika terjadi kesalahan. Hal ini memungkinkan aplikasi untuk segera diberi tahu pada saat penyelesaian, alih-alih mengharuskan aplikasi menunggu hingga saat berikutnya aplikasi dimulai ulang atau dipindahkan ke latar depan untuk meminta penyelesaian.

Aplikasi harus mengimplementasikan IBackgroundTask untuk menjalankan yang menerima pemberitahuan penyelesaian. IBackgroundTask harus didaftarkan menggunakan kelas BackgroundTaskBuilder. Ketika BackgroundTransferCompletionGroup.Trigger digunakan untuk menyiapkan tugas, Infrastruktur Broker akan secara otomatis membatalkan pendaftarannya segera setelah dipicu, sehingga tidak perlu memiliki kode unregistrasi tugas eksplisit.

Tugas latar belakang harus dideklarasikan dalam manifes aplikasi. Aplikasi ini tidak memerlukan akses layar kunci untuk menggunakan BackgroundTransferCompletionGroup.

Konstruktor

BackgroundTransferCompletionGroup()

Membuat objek BackgroundTransferCompletionGroup baru.

Properti

IsEnabled

Mendapatkan nilai yang menunjukkan apakah Aktifkan metode pada BackgroundTransferCompletionGroup telah dipanggil.
Trigger

Mendapatkan IBackgroundTrigger yang digunakan untuk menyiapkan tugas latar belakang yang terkait dengan BackgroundTransferCompletionGroup.

Metode

Enable()

Menunjukkan bahwa BackgroundTransferCompletionGroup selesai dan tidak ada lagi operasi transfer latar belakang (objek DownloadOperation atau UploadOperation ) akan ditambahkan ke grup penyelesaian.

Berlaku untuk

Lihat juga