HttpClient.GetStringAsync Metode

Definisi

Ruang nama:

System.Net.Http

Rakitan:

System.Net.Http.dll

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

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);

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

Task<String>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus ditetapkan.

HttpRequestException

Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server (atau batas waktu hanya untuk .NET Framework).

TaskCanceledException

.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.

UriFormatException

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.

GetStringAsync(Uri)

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);

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

Task<String>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus ditetapkan.

HttpRequestException

Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server (atau batas waktu hanya untuk .NET Framework).

TaskCanceledException

.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.

GetStringAsync(String, CancellationToken)

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

Task<String>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

requestUri adalah null.

HttpRequestException

Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server (atau batas waktu hanya untuk .NET Framework).

TaskCanceledException

.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.

UriFormatException

URI permintaan yang disediakan bukan URI relatif atau absolut yang valid.

OperationCanceledException

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.

GetStringAsync(Uri, CancellationToken)

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

Task<String>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

requestUri adalah null.

HttpRequestException

Permintaan gagal karena masalah mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server (atau batas waktu hanya untuk .NET Framework).

TaskCanceledException

.NET Core dan .NET 5 dan yang lebih baru saja: Permintaan gagal karena waktu habis.

OperationCanceledException

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.