WebClient.OpenWriteAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Membuka aliran untuk menulis data ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

Overload

OpenWriteAsync(Uri, String, Object)	Membuka aliran untuk menulis data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan. Metode ini tidak memblokir utas panggilan.
OpenWriteAsync(Uri, String)	Membuka aliran untuk menulis data ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.
OpenWriteAsync(Uri)	Membuka aliran untuk menulis data ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

OpenWriteAsync(Uri, String, Object)

Sumber:

WebClient.cs

Membuka aliran untuk menulis data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan. Metode ini tidak memblokir utas panggilan.

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

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

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

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

Parameter

address

Uri

URI sumber daya untuk menerima data.

method

String

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

userToken

Object

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

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

Keterangan

Metode ini mengambil aliran bisa-tulis yang digunakan untuk mengirim data ke sumber daya. Aliran diambil secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat streaming tersedia, tambahkan penanganan aktivitas ke OpenWriteCompleted peristiwa. Isi aliran dikirim ke server saat Anda menutup aliran.

method Jika parameter menentukan metode yang tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, dilemparkan WebException dengan properti yang Status diatur untuk menunjukkan kesalahan.

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

Metode ini tidak memblokir utas panggilan saat aliran sedang dibuka. Untuk memblokir saat menunggu aliran, gunakan salah OpenWrite satu metode .

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

Catatan

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

OpenWriteAsync(Uri, String)

Sumber:

WebClient.cs

Membuka aliran untuk menulis data ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

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

public void OpenWriteAsync (Uri address, string? method);

member this.OpenWriteAsync : Uri * string -> unit

Public Sub OpenWriteAsync (address As Uri, method As String)

Parameter

address

Uri

URI sumber daya untuk menerima data.

method

String

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

Pengecualian

ArgumentNullException

Parameternya address adalah null.

Keterangan

Metode ini mengambil aliran bisa-tulis yang digunakan untuk mengirim data ke sumber daya. Aliran diambil menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat streaming tersedia, tambahkan penanganan aktivitas ke OpenWriteCompleted peristiwa. Saat Anda menutup aliran, utas memblokir hingga permintaan dikirim dan address respons diterima.

Metode ini tidak memblokir utas panggilan saat aliran sedang dibuka. Untuk memblokir saat menunggu aliran, gunakan salah OpenWrite satu metode .

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

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

OpenWriteAsync(Uri)

Sumber:

WebClient.cs

Membuka aliran untuk menulis data ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

public:
 void OpenWriteAsync(Uri ^ address);

public void OpenWriteAsync (Uri address);

member this.OpenWriteAsync : Uri -> unit

Public Sub OpenWriteAsync (address As Uri)

Parameter

address

Uri

URI sumber daya untuk menerima data.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

Keterangan

Metode ini mengambil aliran bisa-tulis yang digunakan untuk mengirim data ke sumber daya. Aliran diambil menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat streaming tersedia, tambahkan penanganan aktivitas ke OpenWriteCompleted peristiwa. Saat Anda menutup aliran, utas memblokir hingga permintaan dikirim dan address respons diterima.

Metode ini tidak memblokir utas panggilan saat aliran sedang dibuka. Untuk memblokir saat menunggu aliran, gunakan salah OpenWrite satu metode .

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari 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 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 OpenWrite(Uri).