HttpClient.TryGetBufferAsync(Uri) 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.
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai HttpGetBufferResult dengan nilai IBuffer dalam operasi asinkron. Untuk panduan pemrograman untuk kelas HttpClient, dan contoh kode, lihat topik konseptual HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpGetBufferResult ^, HttpProgress> ^ TryGetBufferAsync(Uri ^ uri) = TryGetBufferAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpGetBufferResult, HttpProgress> TryGetBufferAsync(Uri const& uri);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpGetBufferResult,HttpProgress> TryGetBufferAsync(System.Uri uri);
function tryGetBufferAsync(uri)
Public Function TryGetBufferAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpGetBufferResult, HttpProgress)
Parameter
Mengembalikan
Objek yang mewakili operasi asinkron.
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10, version 1903 (diperkenalkan dalam 10.0.18362.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v8.0)
|
Keterangan
Metode ini biasanya dipanggil saat mengunduh konten biner seperti gambar kecil dan file terkompresi. Konten biner yang sangat besar harus diunduh sebagai aliran dengan HttpClient.TryGetInputStreamAsync untuk mencegah buffering yang tidak diperlukan.
Operasi ini tidak akan memblokir. IAsyncOperationWithProgress yang dikembalikan (dari HttpGetBufferResult dan HttpProgress) selesai setelah seluruh isi respons dibaca.
Kelas HttpClient sering digunakan oleh aplikasi untuk mengunduh lalu mengurai teks. Ada kemungkinan bahwa pengodean karakter yang ditentukan di header Content-Type oleh server HTTP tidak cocok dengan pengodean karakter isi respons HTTP (pengodean XML dalam dokumen XML, misalnya). Salah satu cara untuk menggunakan HttpClient dengan teks adalah dengan memanggil metode TryGetStringAsync dan meneruskan string yang dikembalikan ke pengurai teks. Namun, ini dapat mengakibatkan kesalahan jika Jenis Konten bukan jenis yang dapat diekspresikan sebagai string. Cara yang dapat diandalkan untuk menggunakan HttpClient dengan pengurai XML adalah dengan memanggil metode TryGetBufferAsync dan mengurai buffer untuk elemen "<?xml>". Kemudian gunakan pengodean karakter yang ditentukan ("<xmlversion="1.0" encoding="UTF-8"?>", misalnya) untuk mengurai isi respons HTTP. Untuk format teks lainnya, metode serupa dapat digunakan di mana aplikasi memindai bagian awal isi respons HTTP untuk menentukan pengodean karakter yang digunakan.