HttpClient.GetAsync 方法

定义

以异步操作将 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 实现上引发不同的异常。

适用于

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 实现上引发不同的异常。

适用于

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 实现上引发不同的异常。

适用于

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 实现上引发不同的异常。

适用于

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 实现上引发不同的异常。

适用于

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 实现上引发不同的异常。

适用于

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 实现上引发不同的异常。

适用于

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 实现上引发不同的异常。

适用于