HttpClient.GetStringAsync(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 string dalam operasi asinkron. Untuk panduan pemrograman untuk kelas HttpClient, dan contoh kode, lihat topik konseptual HttpClient .
public:
virtual IAsyncOperationWithProgress<Platform::String ^, HttpProgress> ^ GetStringAsync(Uri ^ uri) = GetStringAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<winrt::hstring, HttpProgress> GetStringAsync(Uri const& uri);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<string,HttpProgress> GetStringAsync(System.Uri uri);
function getStringAsync(uri)
Public Function GetStringAsync (uri As Uri) As IAsyncOperationWithProgress(Of String, HttpProgress)
Parameter
Mengembalikan
IAsyncOperationWithProgress<Platform::String,HttpProgress>
IAsyncOperationWithProgress<winrt::hstring,HttpProgress>
Objek yang mewakili operasi asinkron.
- Atribut
Keterangan
Operasi ini tidak akan memblokir. IAsyncOperationWithProgress (dari string dan HttpProgress) yang dikembalikan selesai setelah seluruh isi respons dibaca.
Kelas HttpClient sering digunakan oleh aplikasi untuk mengunduh lalu mengurai teks. Ada kemungkinan bahwa pengodean karakter yang ditentukan dalam 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 GetStringAsync 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 andal untuk menggunakan HttpClient dengan pengurai XML adalah dengan memanggil metode GetBufferAsync 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.
Di bawah ini adalah pengecualian yang dilemparkan fungsi ini.
E_INVALIDARG
Parameter uri adalah referensi null (Tidak ada di Visual Basic).
Penanganan Pengecualian
Anda harus menulis kode untuk menangani pengecualian ketika Anda memanggil metode ini. Pengecualian dapat diakibatkan oleh kesalahan validasi parameter, kegagalan resolusi nama, dan kesalahan jaringan. Pengecualian dari kesalahan jaringan (hilangnya konektivitas, kegagalan koneksi, dan kegagalan server HTTP, misalnya) dapat terjadi kapan saja. Kesalahan ini mengakibatkan pengecualian dilemparkan. Jika tidak ditangani oleh aplikasi Anda, pengecualian dapat menyebabkan seluruh aplikasi Anda dihentikan oleh runtime. Untuk informasi selengkapnya tentang cara menangani pengecualian, lihat Menangani pengecualian di aplikasi jaringan.