WebClient.UploadStringTaskAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunggah string yang ditentukan ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas. Metode ini tidak memblokir utas panggilan.

Overload

UploadStringTaskAsync(Uri, String, String)	Mengunggah string yang ditentukan ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
UploadStringTaskAsync(String, String, String)	Mengunggah string yang ditentukan ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
UploadStringTaskAsync(String, String)	Mengunggah string yang ditentukan ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
UploadStringTaskAsync(Uri, String)	Mengunggah string yang ditentukan ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

UploadStringTaskAsync(Uri, String, String)

Sumber:

WebClient.cs

Mengunggah string yang ditentukan ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string? method, string data);

member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, method As String, data As String) As Task(Of 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.

Mengembalikan

Task<String>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan String yang berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

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, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah string diunggah ke sumber daya. String dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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

Sebelum mengunggah string, metode ini mengonversinya ke array Byte menggunakan pengodean yang ditentukan dalam properti Encoding. Metode ini memblokir saat string ditransmisikan.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString 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 Network Tracing di .NET Framework.

UploadStringTaskAsync(String, String, String)

Sumber:

WebClient.cs

Mengunggah string yang ditentukan ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string? method, string data);

member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, method As String, data As String) As Task(Of String)

Parameter

address

String

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.

Mengembalikan

Task<String>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan String yang berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

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, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah string diunggah ke sumber daya. String dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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

Sebelum mengunggah string, metode ini mengonversinya ke array Byte menggunakan pengodean yang ditentukan dalam properti Encoding. Metode ini memblokir saat string ditransmisikan.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString 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 Network Tracing di .NET Framework.

UploadStringTaskAsync(String, String)

Sumber:

WebClient.cs

Mengunggah string yang ditentukan ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);

member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)

Parameter

address

String

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.

Mengembalikan

Task<String>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan String yang berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Hati

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

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah string diunggah ke sumber daya. String dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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

Sebelum mengunggah string, metode ini mengonversinya ke array Byte menggunakan pengodean yang ditentukan dalam properti Encoding. Metode ini memblokir saat string ditransmisikan.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString 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 Network Tracing di .NET Framework.

UploadStringTaskAsync(Uri, String)

Sumber:

WebClient.cs

Mengunggah string yang ditentukan ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);

member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of 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.

Mengembalikan

Task<String>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan String yang berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Hati

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

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah string diunggah ke sumber daya. String dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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

Sebelum mengunggah string, metode ini mengonversinya ke array Byte menggunakan pengodean yang ditentukan dalam properti Encoding. Metode ini memblokir saat string ditransmisikan.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString 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 Network Tracing di .NET Framework.