Bagikan melalui

UploadOperation.StartAsync Metode

  • Referensi

Definisi

Ruang nama:
Windows.Networking.BackgroundTransfer
Edit

Memulai operasi unggahan asinkron.

public:
 virtual IAsyncOperationWithProgress<UploadOperation ^, UploadOperation ^> ^ StartAsync() = StartAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<UploadOperation, UploadOperation const&> StartAsync();
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<UploadOperation,UploadOperation> StartAsync();
function startAsync()
Public Function StartAsync () As IAsyncOperationWithProgress(Of UploadOperation, UploadOperation)

Mengembalikan

IAsyncOperationWithProgress<UploadOperation,UploadOperation>

Operasi unggahan asinkron yang menyertakan pembaruan kemajuan.

Atribut
RemoteAsyncAttribute

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.

Operasi pengunggahan harus dijadwalkan menggunakan salah satu metode BackgroundUploader.CreateUpload, BackgroundUploader.CreateUploadAsync , atau BackgroundUploader.CreateUploadFromStreamAsync sebelum metode StartAsync dipanggil.

Penting

Mengantrekan sejumlah besar transfer pada utas UI utama dapat mengakibatkan penurunan performa UI aplikasi Anda, meskipun panggilan dapat ditunggu. Jika Anda mengantre sejumlah besar transfer, disarankan agar Anda memanggil StartAsync pada utas pekerja latar belakang seperti dalam contoh berikut.

operation = await Task.Run(() => { return myUploadOperation.StartAsync(); });

Berlaku untuk

Lihat juga