WebClient.UploadStringAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

netstandard.dll, System.Net.WebClient.dll

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

Overload

Nama	Deskripsi
UploadStringAsync(Uri, String)	Mengunggah string yang ditentukan ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.
UploadStringAsync(Uri, String, String)	Mengunggah string yang ditentukan ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.
UploadStringAsync(Uri, String, String, Object)	Mengunggah string yang ditentukan ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

UploadStringAsync(Uri, String)

Sumber:

WebClient.cs

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

public:
 void UploadStringAsync(Uri ^ address, System::String ^ data);

public void UploadStringAsync(Uri address, string data);

member this.UploadStringAsync : Uri * string -> unit

Public Sub UploadStringAsync (address As Uri, data As String)

Parameter

address

Uri

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

data

String

String yang akan diunggah.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Hati

WebRequest, , HttpWebRequestServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode ini mengirim string ke sumber daya. String dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Sebelum mengunggah string, metode ini mengonversinya menjadi Byte array menggunakan pengodean yang ditentukan dalam Encoding properti . Untuk menerima pemberitahuan saat unggahan string selesai, Anda dapat menambahkan penanganan aktivitas ke UploadStringCompleted peristiwa.

Metode ini tidak memblokir utas panggilan saat string sedang dikirim. Untuk mengirim string dan blok saat menunggu respons server, gunakan salah UploadString 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 ("") dan address tidak berisi URI absolut, address harus URI relatif yang dikombinasikan 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.

Nota

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 mengembalikan 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 UploadString(Uri, String).

UploadStringAsync(Uri, String, String)

Sumber:

WebClient.cs

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

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data);

public void UploadStringAsync(Uri address, string? method, string data);

member this.UploadStringAsync : Uri * string * string -> unit

Public Sub UploadStringAsync (address As Uri, method As String, data As String)

Parameter

address

Uri

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

method

String

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

data

String

String yang akan diunggah.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

method tidak dapat digunakan untuk mengirim isi.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Hati

WebRequest, , HttpWebRequestServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode ini mengirim string ke sumber daya. String dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Sebelum mengunggah string, metode ini mengonversinya menjadi Byte array menggunakan pengodean yang ditentukan dalam Encoding properti . Untuk menerima pemberitahuan saat unggahan string selesai, Anda dapat menambahkan penanganan aktivitas ke UploadStringCompleted peristiwa.

Metode ini tidak memblokir utas panggilan saat string sedang dikirim. Untuk mengirim string dan blok saat menunggu respons server, gunakan salah UploadString 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 ("") dan address tidak berisi URI absolut, address harus URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Nota

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 mengembalikan 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 UploadString(Uri, String, String).

UploadStringAsync(Uri, String, String, Object)

Sumber:

WebClient.cs

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

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data, System::Object ^ userToken);

public void UploadStringAsync(Uri address, string? method, string data, object? userToken);

member this.UploadStringAsync : Uri * string * string * obj -> unit

Public Sub UploadStringAsync (address As Uri, method As String, data As String, userToken As Object)

Parameter

address

Uri

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

method

String

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

data

String

String yang akan diunggah.

userToken

Object

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

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

method tidak dapat digunakan untuk mengirim isi.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Hati

WebRequest, , HttpWebRequestServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode ini mengirim string ke sumber daya. String dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Sebelum mengunggah string, metode ini mengonversinya menjadi Byte array menggunakan pengodean yang ditentukan dalam Encoding properti . Untuk menerima pemberitahuan saat unggahan string selesai, Anda dapat menambahkan penanganan aktivitas ke UploadStringCompleted peristiwa.

Metode ini tidak memblokir utas panggilan saat string sedang dikirim. Untuk mengirim string dan blok saat menunggu respons server, gunakan salah UploadString 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 ("") dan address tidak berisi URI absolut, address harus URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Nota

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