WebClient.OpenWriteTaskAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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 address
null
.
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 address
null
.
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 address
null
.
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 address
null
.
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.