DownloadOperation.AttachAsync Metode

Referensi

Definisi

Ruang nama:: Windows.Networking.BackgroundTransfer

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mengembalikan operasi asinkron yang dapat digunakan untuk memantau kemajuan dan penyelesaian unduhan terlampir. Memanggil metode ini memungkinkan aplikasi untuk melampirkan operasi pengunduhan yang dimulai dalam instans aplikasi sebelumnya.

public:
 virtual IAsyncOperationWithProgress<DownloadOperation ^, DownloadOperation ^> ^ AttachAsync() = AttachAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DownloadOperation, DownloadOperation const&> AttachAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DownloadOperation,DownloadOperation> AttachAsync();

function attachAsync()

Public Function AttachAsync () As IAsyncOperationWithProgress(Of DownloadOperation, DownloadOperation)

Mengembalikan

IAsyncOperationWithProgress<DownloadOperation,DownloadOperation>

Unduh operasi dengan panggilan balik.

Atribut: RemoteAsyncAttribute

Contoh

function AttachDownload (loadedDownload) {
    try {
        download = loadedDownload;
        promise = download.attachAsync().then(complete, error, progress);
    } catch (err) {
        displayException(err);
    }
};

Keterangan

Pengecualian

COMException

Disingkirkan saat HRESULT khusus fitur dikembalikan dari panggilan metode.

Ini adalah pengecualian paling umum yang dilemparkan oleh metode jaringan. Aplikasi harus menggunakan HRESULT dari pengecualian untuk menentukan penyebab kesalahan.

AccessDeniedException

Disingkirkan saat akses ditolak ke sumber daya atau fitur. Pengecualian ini terjadi ketika aplikasi tidak memiliki kemampuan jaringan yang diperlukan yang diatur dalam manifes aplikasi untuk operasi jaringan yang diminta.

InvalidArgumentException

Disingkirkan ketika salah satu argumen yang diberikan ke metode tidak valid.

Jika input yang disediakan pengguna menyebabkan pengecualian ini, aplikasi dapat memberi tahu pengguna dan meminta input baru.

ObjectDisposedException

Disingkirkan ketika operasi dilakukan pada objek yang dibuang.

OutOfMemoryException

Disingkirkan ketika memori tidak mencukup tersedia untuk menyelesaikan operasi.

Meskipun, metode ini dapat dipanggil dari beberapa instans aplikasi, pengembang tidak boleh melampirkan panggilan balik dari instans aplikasi utama dalam tugas latar belakang. Ini akan menyebabkan BackgroundTransferHost.exe menggantung.

Berlaku untuk

Bagikan melalui