Bagikan melalui

WebClient.UploadFileAsync Metode

  • Referensi

Definisi

Ruang nama:
System.Net
Rakitan:
System.Net.WebClient.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

Overload

UploadFileAsync(Uri, String)

Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST. Metode ini tidak memblokir utas panggilan.
UploadFileAsync(Uri, String, String)

Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST. Metode ini tidak memblokir utas panggilan.
UploadFileAsync(Uri, String, String, Object)

Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST. Metode ini tidak memblokir utas panggilan.

UploadFileAsync(Uri, String)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST. Metode ini tidak memblokir utas panggilan.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ fileName);
public void UploadFileAsync (Uri address, string fileName);
member this.UploadFileAsync : Uri * string -> unit
Public Sub UploadFileAsync (address As Uri, fileName As String)

Parameter

address
Uri

URI sumber daya untuk menerima file. Untuk sumber daya HTTP, URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode POST, seperti halaman skrip atau ASP.

fileName
String

File yang akan dikirim ke sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

fileName adalah null, adalah Empty, berisi karakter yang tidak valid, atau jalur yang ditentukan ke file tidak ada.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Keterangan

File dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat pengunggahan file selesai, tambahkan penanganan aktivitas ke UploadFileCompleted acara.

Metode ini tidak memblokir utas panggilan saat file sedang dikirim. Untuk mengirim file dan blokir sambil menunggu respons server, gunakan salah UploadFile satu metode.

Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .

BaseAddress Jika properti bukan string kosong (""), address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh UploadFile(Uri, String).

Berlaku untuk

UploadFileAsync(Uri, String, String)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST. Metode ini tidak memblokir utas panggilan.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);
public void UploadFileAsync (Uri address, string? method, string fileName);
public void UploadFileAsync (Uri address, string method, string fileName);
member this.UploadFileAsync : Uri * string * string -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String)

Parameter

address
Uri

URI sumber daya untuk menerima file. Untuk sumber daya HTTP, URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode POST, seperti halaman skrip atau ASP.

method
String

Metode yang digunakan untuk mengirim data ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

fileName
String

File yang akan dikirim ke sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

fileName adalah null, adalah Empty, berisi karakter yang tidak valid, atau jalur yang ditentukan ke file tidak ada.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Keterangan

File dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat pengunggahan file selesai, tambahkan penanganan aktivitas ke UploadFileCompleted acara.

Metode ini tidak memblokir utas panggilan saat file sedang dikirim. Untuk mengirim file dan blokir sambil menunggu respons server, gunakan salah UploadFile satu metode.

Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .

BaseAddress Jika properti bukan string kosong (""), address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh UploadFile(Uri, String, String).

Berlaku untuk

UploadFileAsync(Uri, String, String, Object)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST. Metode ini tidak memblokir utas panggilan.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName, System::Object ^ userToken);
public void UploadFileAsync (Uri address, string? method, string fileName, object? userToken);
public void UploadFileAsync (Uri address, string method, string fileName, object userToken);
member this.UploadFileAsync : Uri * string * string * obj -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)

Parameter

address
Uri

URI sumber daya untuk menerima file. Untuk sumber daya HTTP, URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode POST, seperti halaman skrip atau ASP.

method
String

Metode yang digunakan untuk mengirim data ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

fileName
String

File yang akan dikirim ke sumber daya.

userToken
Object

Objek yang ditentukan pengguna yang diteruskan ke metode yang dipanggil saat operasi asinkron selesai.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

fileName adalah null, adalah Empty, berisi karakter yang tidak valid, atau jalur yang ditentukan ke file tidak ada.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Keterangan

File dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat pengunggahan file selesai, tambahkan penanganan aktivitas ke UploadFileCompleted acara.

Metode ini tidak memblokir utas panggilan saat file sedang dikirim. Untuk mengirim file dan memblokir sambil menunggu respons server, gunakan salah UploadFile satu metode .

Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .

BaseAddress Jika properti bukan string kosong (""), address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Berlaku untuk