HttpClient.GetAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
以非同步作業的方式，將 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)
以非同步作業的方式，將 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 實作會擲回不同的例外狀況。
- HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
- TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
- TaskCanceledException會在 .NET 5 和更新版本上擲回 巢狀 。TimeoutException
適用於
GetAsync(Uri)
以非同步作業的方式，將 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 實作會擲回不同的例外狀況。
- HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
- TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
- TaskCanceledException會在 .NET 5 和更新版本上擲回 巢狀 。TimeoutException
適用於
GetAsync(String, HttpCompletionOption)
以非同步作業的方式，傳送 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 實作會擲回不同的例外狀況。
- HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
- TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
- TaskCanceledException會在 .NET 5 和更新版本上擲回 巢狀 。TimeoutException
適用於
GetAsync(String, CancellationToken)
以非同步作業的方式，傳送 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 實作會擲回不同的例外狀況。
- HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
- TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
- TaskCanceledException會在 .NET 5 和更新版本上擲回 巢狀 。TimeoutException
適用於
GetAsync(Uri, HttpCompletionOption)
以非同步作業的方式，傳送 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 實作會擲回不同的例外狀況。
- HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
- TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
- TaskCanceledException會在 .NET 5 和更新版本上擲回 巢狀 。TimeoutException
適用於
GetAsync(Uri, CancellationToken)
以非同步作業的方式，傳送 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 實作會擲回不同的例外狀況。
- HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
- TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
- TaskCanceledExceptionTimeoutException，會在 .NET 5 和更新版本上擲回 巢狀 。
適用於
GetAsync(String, HttpCompletionOption, CancellationToken)
以非同步作業的方式，傳送 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 實作會擲回不同的例外狀況。
- HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
- TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
- TaskCanceledExceptionTimeoutException，會在 .NET 5 和更新版本上擲回 巢狀 。
適用於
GetAsync(Uri, HttpCompletionOption, CancellationToken)
以非同步作業的方式，傳送 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 實作會擲回不同的例外狀況。
- HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
- TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
- TaskCanceledExceptionTimeoutException，會在 .NET 5 和更新版本上擲回 巢狀 。
