Bagikan melalui


WebClient.OpenWriteTaskAsync Metode

Definisi

Membuka aliran untuk menulis data ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas. Metode ini tidak memblokir utas panggilan.

Overload

OpenWriteTaskAsync(String)

Membuka aliran untuk menulis data ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

OpenWriteTaskAsync(Uri)

Membuka aliran untuk menulis data ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

OpenWriteTaskAsync(String, String)

Membuka aliran untuk menulis data ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

OpenWriteTaskAsync(Uri, String)

Membuka aliran untuk menulis data ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

OpenWriteTaskAsync(String)

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

Membuka aliran untuk menulis data ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);
member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)

Parameter

address
String

URI sumber daya untuk menerima data.

Mengembalikan

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan Stream yang digunakan untuk menulis data ke sumber daya.

Atribut

Pengecualian

Parameter addressnull.

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

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 aliran bisa-tulis ke sumber daya data dibuka. Metode ini tidak memblokir utas panggilan saat aliran terbuka.

Metode ini mengambil instans Stream yang digunakan untuk menulis data ke sumber daya yang ditentukan oleh parameter address. Aliran diperoleh menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Nota

Anda harus memanggil Stream.Close setelah selesai dengan Stream untuk menghindari kehabisan sumber daya sistem.

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

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.

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

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

Lihat juga

Berlaku untuk

OpenWriteTaskAsync(Uri)

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

Membuka aliran untuk menulis data ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);
member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)

Parameter

address
Uri

URI sumber daya untuk menerima data.

Mengembalikan

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan Stream yang digunakan untuk menulis data ke sumber daya.

Atribut

Pengecualian

Parameter addressnull.

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

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 aliran bisa-tulis ke sumber daya data dibuka. Metode ini tidak memblokir utas panggilan saat aliran terbuka.

Metode ini mengambil instans Stream yang digunakan untuk menulis data ke sumber daya yang ditentukan oleh parameter address. Aliran diperoleh menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Nota

Anda harus memanggil Stream.Close setelah selesai dengan Stream untuk menghindari kehabisan sumber daya sistem.

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

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.

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

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

Berlaku untuk

OpenWriteTaskAsync(String, String)

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

Membuka aliran untuk menulis data ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address, System::String ^ method);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string? method);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string method);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string method);
member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)

Parameter

address
String

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.

Mengembalikan

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan Stream yang digunakan untuk menulis data ke sumber daya.

Atribut

Pengecualian

Parameter addressnull.

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

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 aliran bisa-tulis ke sumber daya data dibuka. Metode ini tidak memblokir utas panggilan saat aliran terbuka.

Metode ini mengambil instans Stream yang digunakan untuk menulis data ke sumber daya yang ditentukan oleh parameter address. Aliran diperoleh menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Nota

Anda harus memanggil Stream.Close setelah selesai dengan Stream untuk menghindari kehabisan sumber daya sistem.

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

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

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.

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

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

Lihat juga

Berlaku untuk

OpenWriteTaskAsync(Uri, String)

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

Membuka aliran untuk menulis data ke sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address, System::String ^ method);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string? method);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string method);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string method);
member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)

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.

Mengembalikan

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan Stream yang digunakan untuk menulis data ke sumber daya.

Atribut

Pengecualian

Parameter addressnull.

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

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 aliran bisa-tulis ke sumber daya data dibuka. Metode ini tidak memblokir utas panggilan saat aliran terbuka.

Metode ini mengambil instans Stream yang digunakan untuk menulis data ke sumber daya yang ditentukan oleh parameter address. Aliran diperoleh menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Nota

Anda harus memanggil Stream.Close setelah selesai dengan Stream untuk menghindari kehabisan sumber daya sistem.

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

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

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.

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

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

Lihat juga

Berlaku untuk