HttpClient.GetAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
以异步操作将 GET 请求发送给指定 URI。
重载
| GetAsync(String) |
以异步操作将 GET 请求发送给指定 URI。 |
| GetAsync(Uri) |
以异步操作将 GET 请求发送给指定 URI。 |
| GetAsync(String, HttpCompletionOption) |
用以异步操作的 HTTP 完成选项发送 GET 请求到指定的 URI。 |
| GetAsync(String, CancellationToken) |
用以异步操作的取消标记发送 GET 请求到指定的 URI。 |
| GetAsync(Uri, HttpCompletionOption) |
用以异步操作的 HTTP 完成选项发送 GET 请求到指定的 URI。 |
| GetAsync(Uri, CancellationToken) |
用以异步操作的取消标记发送 GET 请求到指定的 URI。 |
| GetAsync(String, HttpCompletionOption, CancellationToken) |
用以异步操作的 HTTP 完成选项和取消标记发送 GET 请求到指定的 URI。 |
| GetAsync(Uri, HttpCompletionOption, CancellationToken) |
用以异步操作的 HTTP 完成选项和取消标记发送 GET 请求到指定的 URI。 |
注解
操作不会阻止。
GetAsync(String)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- 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 或绝对 URI。
注解
此操作不会阻止。 返回 Task<TResult> 的对象将在读取整个响应 (包括内容) 之后完成。 该行为与显式指定时的行为相同 ResponseContentRead 。
备注
如果出现超时，则会在不同的 .NET 实现上引发不同的异常。
- HttpRequestException在所有适用的 .NET Framework 版本上引发。
- TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
- TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。
适用于
GetAsync(Uri)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- 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 实现上引发不同的异常。
- HttpRequestException在所有适用的 .NET Framework 版本上引发。
- TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
- TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。
适用于
GetAsync(String, HttpCompletionOption)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
用以异步操作的 HTTP 完成选项发送 GET 请求到指定的 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 或绝对 URI。
注解
此操作不会阻止。 在读取部分 Task<TResult> 或所有响应 (包括内容) 之后，返回的对象将基于 completionOption 参数完成。
备注
如果出现超时，则会在不同的 .NET 实现上引发不同的异常。
- HttpRequestException在所有适用的 .NET Framework 版本上引发。
- TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
- TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。
适用于
GetAsync(String, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- 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 或绝对 URI。
取消令牌已取消。 此异常存储在返回的任务中。
注解
此操作不会阻止。 返回 Task<TResult> 的对象将在读取整个响应 (包括内容) 之后完成。 该行为与显式指定时的行为相同 ResponseContentRead 。
备注
如果出现超时，则会在不同的 .NET 实现上引发不同的异常。
- HttpRequestException在所有适用的 .NET Framework 版本上引发。
- TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
- TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。
适用于
GetAsync(Uri, HttpCompletionOption)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
用以异步操作的 HTTP 完成选项发送 GET 请求到指定的 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)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- 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 实现上引发不同的异常。
- HttpRequestException在所有适用的 .NET Framework 版本上引发 。
- TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
- TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。
适用于
GetAsync(String, HttpCompletionOption, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
用以异步操作的 HTTP 完成选项和取消标记发送 GET 请求到指定的 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 或绝对 URI。
取消令牌已取消。 此异常存储在返回的任务中。
注解
此操作不会阻止。 在读取部分或全部响应 (包括内容) 之后，返回 Task<TResult> 的对象将基于 completionOption 参数完成。
备注
如果出现超时，则会在不同的 .NET 实现上引发不同的异常。
- HttpRequestException在所有适用的 .NET Framework 版本上引发 。
- TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
- TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。
适用于
GetAsync(Uri, HttpCompletionOption, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
用以异步操作的 HTTP 完成选项和取消标记发送 GET 请求到指定的 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 版本上引发任何内部异常。
- TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈