共用方式為


HttpClient.GetAsync 方法

定義

以非同步作業的方式,將 GET 要求傳送至指定的 URI。

多載

GetAsync(String)

以非同步作業的方式,將 GET 要求傳送至指定的 URI。

GetAsync(Uri)

以非同步作業的方式,將 GET 要求傳送至指定的 URI。

GetAsync(String, HttpCompletionOption)

以非同步作業的方式,傳送 GET 要求和 HTTP 完成選項至指定的 Uri。

GetAsync(String, CancellationToken)

以非同步作業的方式,傳送 GET 要求和取消權杖至指定的 Uri。

GetAsync(Uri, HttpCompletionOption)

以非同步作業的方式,傳送 GET 要求和 HTTP 完成選項至指定的 Uri。

GetAsync(Uri, CancellationToken)

以非同步作業的方式,傳送 GET 要求和取消權杖至指定的 Uri。

GetAsync(String, HttpCompletionOption, CancellationToken)

以非同步作業的方式,傳送 GET 要求和 HTTP 完成選項以及取消語彙基元至指定的 Uri。

GetAsync(Uri, HttpCompletionOption, CancellationToken)

以非同步作業的方式,傳送 GET 要求和 HTTP 完成選項以及取消語彙基元至指定的 Uri。

備註

作業不會封鎖。

GetAsync(String)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
HttpClient.cs

以非同步作業的方式,將 GET 要求傳送至指定的 URI。

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

參數

requestUri
String

傳送要求的目標 URI。

傳回

工作物件,表示非同步作業。

例外狀況

requestUri 必須是絕對 URI,否則必須設定 BaseAddress

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

僅限 .NET Core 和 .NET 5 和更新版本:要求因逾時而失敗。

提供的要求 URI 不是有效的相對或絕對 URI。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件會在讀取完整的回應 (包括內容) 之後完成。 行為與明確指定的行為 ResponseContentRead 相同。

注意

如果逾時,不同的 .NET 實作會擲回不同的例外狀況。

適用於

GetAsync(Uri)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
HttpClient.cs

以非同步作業的方式,將 GET 要求傳送至指定的 URI。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);
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)

參數

requestUri
Uri

傳送要求的目標 URI。

傳回

工作物件,表示非同步作業。

例外狀況

requestUri 必須是絕對 URI,否則必須設定 BaseAddress

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

僅限 .NET Core 和 .NET 5 和更新版本:要求因逾時而失敗。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件會在讀取完整的回應 (包括內容) 之後完成。 行為與明確指定的行為 ResponseContentRead 相同。

注意

如果逾時,不同的 .NET 實作會擲回不同的例外狀況。

適用於

GetAsync(String, HttpCompletionOption)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
HttpClient.cs

以非同步作業的方式,傳送 GET 要求和 HTTP 完成選項至指定的 Uri。

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

參數

requestUri
String

傳送要求的目標 URI。

completionOption
HttpCompletionOption

HTTP 完成選項值,表示作業應該被視為已完成。

傳回

工作物件,表示非同步作業。

例外狀況

requestUri 必須是絕對 URI,否則必須設定 BaseAddress

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

僅限 .NET Core 和 .NET 5 和更新版本:要求因逾時而失敗。

提供的要求 URI 不是有效的相對或絕對 URI。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件何時完成,將在讀取部分或所有回應 (包括內容) 之後,根據 completionOption 參數決定。

注意

如果逾時,不同的 .NET 實作會擲回不同的例外狀況。

適用於

GetAsync(String, CancellationToken)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
HttpClient.cs

以非同步作業的方式,傳送 GET 要求和取消權杖至指定的 Uri。

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

參數

requestUri
String

傳送要求的目標 URI。

cancellationToken
CancellationToken

取消語彙基元,可由其他物件或執行緒用來接收取消通知。

傳回

工作物件,表示非同步作業。

例外狀況

requestUri 必須是絕對 URI,否則必須設定 BaseAddress

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

僅限 .NET Core 和 .NET 5 和更新版本:要求因逾時而失敗。

提供的要求 URI 不是有效的相對或絕對 URI。

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件會在讀取完整的回應 (包括內容) 之後完成。 行為與明確指定的行為 ResponseContentRead 相同。

注意

如果逾時,不同的 .NET 實作會擲回不同的例外狀況。

適用於

GetAsync(Uri, HttpCompletionOption)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
HttpClient.cs

以非同步作業的方式,傳送 GET 要求和 HTTP 完成選項至指定的 Uri。

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

參數

requestUri
Uri

傳送要求的目標 URI。

completionOption
HttpCompletionOption

HTTP 完成選項值,表示作業應該被視為已完成。

傳回

工作物件,表示非同步作業。

例外狀況

requestUri 必須是絕對 URI,否則必須設定 BaseAddress

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

僅限 .NET Core 和 .NET 5 和更新版本:要求因逾時而失敗。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件何時完成,將在讀取部分或所有回應 (包括內容) 之後,根據 completionOption 參數決定。

注意

如果逾時,不同的 .NET 實作會擲回不同的例外狀況。

適用於

GetAsync(Uri, CancellationToken)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
HttpClient.cs

以非同步作業的方式,傳送 GET 要求和取消權杖至指定的 Uri。

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

參數

requestUri
Uri

傳送要求的目標 URI。

cancellationToken
CancellationToken

取消語彙基元,可由其他物件或執行緒用來接收取消通知。

傳回

工作物件,表示非同步作業。

例外狀況

requestUri 必須是絕對 URI,否則必須設定 BaseAddress

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

僅限 .NET Core 和 .NET 5 和更新版本:要求因逾時而失敗。

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件會在讀取完整的回應 (包括內容) 之後完成。 行為與明確指定的行為相同 ResponseContentRead

注意

如果逾時,不同的 .NET 實作會擲回不同的例外狀況。

適用於

GetAsync(String, HttpCompletionOption, CancellationToken)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
HttpClient.cs

以非同步作業的方式,傳送 GET 要求和 HTTP 完成選項以及取消語彙基元至指定的 Uri。

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

參數

requestUri
String

傳送要求的目標 URI。

completionOption
HttpCompletionOption

HTTP 完成選項值,表示作業應該被視為已完成。

cancellationToken
CancellationToken

取消語彙基元,可由其他物件或執行緒用來接收取消通知。

傳回

工作物件,表示非同步作業。

例外狀況

requestUri 必須是絕對 URI,否則必須設定 BaseAddress

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

僅限 .NET Core 和 .NET 5 和更新版本:要求因逾時而失敗。

所提供的要求 URI 不是有效的相對或絕對 URI。

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件何時完成,將在讀取部分或所有回應 (包括內容) 之後,根據 completionOption 參數決定。

注意

如果逾時,不同的 .NET 實作會擲回不同的例外狀況。

適用於

GetAsync(Uri, HttpCompletionOption, CancellationToken)

來源:
HttpClient.cs
來源:
HttpClient.cs
來源:
HttpClient.cs

以非同步作業的方式,傳送 GET 要求和 HTTP 完成選項以及取消語彙基元至指定的 Uri。

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

參數

requestUri
Uri

傳送要求的目標 URI。

completionOption
HttpCompletionOption

HTTP 完成選項值,表示作業應該被視為已完成。

cancellationToken
CancellationToken

取消語彙基元,可由其他物件或執行緒用來接收取消通知。

傳回

工作物件,表示非同步作業。

例外狀況

requestUri 必須是絕對 URI,否則必須設定 BaseAddress

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

僅限 .NET Core 和 .NET 5 和更新版本:要求因逾時而失敗。

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回的 Task<TResult> 物件何時完成,將在讀取部分或所有回應 (包括內容) 之後,根據 completionOption 參數決定。

注意

如果逾時,不同的 .NET 實作會擲回不同的例外狀況。

適用於