HttpClient.GetStringAsync 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.
Overload
| GetStringAsync(String) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron. |
| GetStringAsync(Uri) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron. |
| GetStringAsync(String, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron. |
| GetStringAsync(Uri, CancellationToken) |
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron. |
Keterangan
Operasi ini tidak akan memblokir.
GetStringAsync(String)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (string requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri);member this.GetStringAsync : string -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As String) As Task(Of String)Parameter
- requestUri
- String
Uri tempat permintaan dikirim.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
requestUri harus merupakan URI absolut atau BaseAddress harus ditetapkan.
Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server (atau batas waktu hanya untuk .NET Framework).
.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.
URI permintaan yang disediakan bukan URI relatif atau absolut yang valid.
Keterangan
Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh isi respons dibaca.
Catatan
Dalam kasus waktu habis:
- .NET Framework melempar HttpRequestException.
- .NET Core melempar TaskCanceledException tanpa pengecualian dalam.
- .NET 5 dan versi yang TaskCanceledException lebih baru melemparkan yang menumpuk TimeoutException.
Berlaku untuk
GetStringAsync(Uri)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (Uri requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri);member this.GetStringAsync : Uri -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As Uri) As Task(Of String)Parameter
- requestUri
- Uri
Uri tempat permintaan dikirim.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
requestUri harus merupakan URI absolut atau BaseAddress harus ditetapkan.
Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server (atau batas waktu hanya untuk .NET Framework).
.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.
Keterangan
Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh isi respons dibaca.
Catatan
Dalam kasus waktu habis:
- .NET Framework melempar HttpRequestException.
- .NET Core melempar TaskCanceledException tanpa pengecualian dalam.
- .NET 5 dan versi yang TaskCanceledException lebih baru melemparkan yang menumpuk TimeoutException.
Berlaku untuk
GetStringAsync(String, CancellationToken)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetStringAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of String)Parameter
- requestUri
- String
Uri tempat permintaan dikirim.
- cancellationToken
- CancellationToken
Token pembatalan untuk membatalkan operasi.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
requestUri adalah null.
Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server (atau batas waktu hanya untuk .NET Framework).
.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.
URI permintaan yang disediakan bukan URI relatif atau absolut yang valid.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh isi respons dibaca.
Catatan
Dalam kasus waktu habis:
- .NET Framework melempar HttpRequestException.
- .NET Core melempar TaskCanceledException tanpa pengecualian dalam.
- .NET 5 dan versi yang TaskCanceledException lebih baru melemparkan yang menumpuk TimeoutException.
Berlaku untuk
GetStringAsync(Uri, CancellationToken)
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
- Sumber:
- HttpClient.cs
Kirim permintaan GET ke Uri yang ditentukan dan kembalikan isi respons sebagai string dalam operasi asinkron.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetStringAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of String)Parameter
- requestUri
- Uri
Uri tempat permintaan dikirim.
- cancellationToken
- CancellationToken
Token pembatalan untuk membatalkan operasi.
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
requestUri adalah null.
Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server (atau batas waktu hanya untuk .NET Framework).
.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh isi respons dibaca.
Catatan
Dalam kasus waktu habis:
- .NET Framework melempar HttpRequestException.
- .NET Core melempar TaskCanceledException tanpa pengecualian dalam.
- .NET 5 dan versi yang TaskCanceledException lebih baru melemparkan yang menumpuk TimeoutException.
