HttpClient.GetAsync Metode

Definisi

Ruang nama:

System.Net.Http

Rakitan:

System.Net.Http.dll

Kirim permintaan GET ke Uri yang ditentukan sebagai operasi asinkron.

Overload

GetAsync(String)	Kirim permintaan GET ke Uri yang ditentukan sebagai operasi asinkron.
GetAsync(Uri)	Kirim permintaan GET ke Uri yang ditentukan sebagai operasi asinkron.
GetAsync(String, HttpCompletionOption)	Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP sebagai operasi asinkron.
GetAsync(String, CancellationToken)	Kirim permintaan GET ke Uri yang ditentukan dengan token pembatalan sebagai operasi asinkron.
GetAsync(Uri, HttpCompletionOption)	Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP sebagai operasi asinkron.
GetAsync(Uri, CancellationToken)	Kirim permintaan GET ke Uri yang ditentukan dengan token pembatalan sebagai operasi asinkron.
GetAsync(String, HttpCompletionOption, CancellationToken)	Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP dan token pembatalan sebagai operasi asinkron.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP dan token pembatalan sebagai operasi asinkron.

Keterangan

Operasi tidak akan diblokir.

GetAsync(String)

Sumber:

HttpClient.cs

Kirim permintaan GET ke Uri yang ditentukan sebagai operasi asinkron.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri);

member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)

Parameter

requestUri

String

Uri tempat permintaan dikirim.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus diatur.

HttpRequestException

Permintaan gagal karena masalah yang mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

TaskCanceledException

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

UriFormatException

URI permintaan yang disediakan tidak valid URI relatif atau absolut.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh respons (termasuk konten) dibaca. Perilakunya sama seperti jika ResponseContentRead telah ditentukan secara eksplisit.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk dilemparkan TimeoutException pada .NET 5 dan versi yang lebih baru.

GetAsync(Uri)

Sumber:

HttpClient.cs

Kirim permintaan GET ke Uri yang ditentukan sebagai operasi asinkron.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri);

member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)

Parameter

requestUri

Uri

Uri tempat permintaan dikirim.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus diatur.

HttpRequestException

Permintaan gagal karena masalah yang mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

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 respons (termasuk konten) dibaca. Perilakunya sama seperti jika ResponseContentRead telah ditentukan secara eksplisit.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk dilemparkan TimeoutException pada .NET 5 dan versi yang lebih baru.

GetAsync(String, HttpCompletionOption)

Sumber:

HttpClient.cs

Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP sebagai operasi asinkron.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parameter

requestUri

String

Uri tempat permintaan dikirim.

completionOption

HttpCompletionOption

Nilai opsi penyelesaian HTTP yang menunjukkan kapan operasi harus dianggap selesai.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus diatur.

HttpRequestException

Permintaan gagal karena masalah yang mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

TaskCanceledException

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

UriFormatException

URI permintaan yang disediakan tidak valid URI relatif atau absolut.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai berdasarkan completionOption parameter setelah bagian atau semua respons (termasuk konten) dibaca.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk dilemparkan TimeoutException pada .NET 5 dan versi yang lebih baru.

GetAsync(String, CancellationToken)

Sumber:

HttpClient.cs

Kirim permintaan GET ke Uri yang ditentukan dengan token pembatalan sebagai operasi asinkron.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parameter

requestUri

String

Uri tempat permintaan dikirim.

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan oleh objek atau utas lain untuk menerima pemberitahuan pembatalan.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus diatur.

HttpRequestException

Permintaan gagal karena masalah yang mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

TaskCanceledException

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

UriFormatException

URI permintaan yang disediakan tidak valid URI relatif atau absolut.

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 respons (termasuk konten) dibaca. Perilakunya sama seperti jika ResponseContentRead telah ditentukan secara eksplisit.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk dilemparkan TimeoutException pada .NET 5 dan versi yang lebih baru.

GetAsync(Uri, HttpCompletionOption)

Sumber:

HttpClient.cs

Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP sebagai operasi asinkron.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parameter

requestUri

Uri

Uri tempat permintaan dikirim.

completionOption

HttpCompletionOption

Nilai opsi penyelesaian HTTP yang menunjukkan kapan operasi harus dianggap selesai.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus diatur.

HttpRequestException

Permintaan gagal karena masalah yang mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

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 berdasarkan completionOption parameter setelah bagian atau semua respons (termasuk konten) dibaca.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk dilemparkan TimeoutException pada .NET 5 dan versi yang lebih baru.

GetAsync(Uri, CancellationToken)

Sumber:

HttpClient.cs

Kirim permintaan GET ke Uri yang ditentukan dengan token pembatalan sebagai operasi asinkron.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parameter

requestUri

Uri

Uri tempat permintaan dikirim.

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan oleh objek atau utas lain untuk menerima pemberitahuan pembatalan.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus diatur.

HttpRequestException

Permintaan gagal karena masalah yang mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

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 respons (termasuk konten) dibaca. Perilakunya sama seperti jika ResponseContentRead telah ditentukan secara eksplisit.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk dilemparkan TimeoutException pada .NET 5 dan versi yang lebih baru.

GetAsync(String, HttpCompletionOption, CancellationToken)

Sumber:

HttpClient.cs

Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP dan token pembatalan sebagai operasi asinkron.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parameter

requestUri

String

Uri tempat permintaan dikirim.

completionOption

HttpCompletionOption

Nilai opsi penyelesaian HTTP yang menunjukkan kapan operasi harus dianggap selesai.

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan oleh objek atau utas lain untuk menerima pemberitahuan pembatalan.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus diatur.

HttpRequestException

Permintaan gagal karena masalah yang mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

TaskCanceledException

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

UriFormatException

URI permintaan yang disediakan tidak valid URI relatif atau absolut.

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 berdasarkan completionOption parameter setelah bagian atau semua respons (termasuk konten) dibaca.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk dilemparkan TimeoutException pada .NET 5 dan versi yang lebih baru.

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Sumber:

HttpClient.cs

Kirim permintaan GET ke Uri yang ditentukan dengan opsi penyelesaian HTTP dan token pembatalan sebagai operasi asinkron.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parameter

requestUri

Uri

Uri tempat permintaan dikirim.

completionOption

HttpCompletionOption

Nilai opsi penyelesaian HTTP yang menunjukkan kapan operasi harus dianggap selesai.

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan oleh objek atau utas lain untuk menerima pemberitahuan pembatalan.

Mengembalikan

Task<HttpResponseMessage>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri harus merupakan URI absolut atau BaseAddress harus diatur.

HttpRequestException

Permintaan gagal karena masalah yang mendasar seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

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 berdasarkan completionOption parameter setelah bagian atau semua respons (termasuk konten) dibaca.

Catatan

Dalam kasus waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestExceptiondilemparkan pada semua versi .NET Framework yang berlaku.
• TaskCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• TaskCanceledException yang menumpuk dilemparkan TimeoutException pada .NET 5 dan versi yang lebih baru.