HttpClient.GetStringAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。
重载
| GetStringAsync(String) |
将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。 |
| GetStringAsync(Uri) |
将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。 |
| GetStringAsync(String, CancellationToken) |
将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。 |
| GetStringAsync(Uri, CancellationToken) |
将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。 |
注解
此操作不会阻止。
GetStringAsync(String)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (string requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri);member this.GetStringAsync : string -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As String) As Task(Of String)参数
- requestUri
- String
请求发送到的 URI。
返回
表示异步操作的任务对象。
例外
requestUri 必须为绝对 URI 或必须设置 BaseAddress。
由于基础问题（如网络连接性、DNS 失败、服务器证书验证或仅 .NET Framework 超时），请求失败。
仅限 .NET Core 和 .NET 5 及更高版本：请求因超时而失败。
提供的请求 URI 是无效的相对 URI 或绝对 URI。
注解
此操作不会阻止。 Task<TResult>返回的对象将在读取整个响应正文后完成。
注意
发生超时时：
- .NET Framework引发 HttpRequestException。
- .NET Core 引发 TaskCanceledException 没有任何内部异常。
- .NET 5 及更高版本引发嵌套 TaskCanceledException 的 TimeoutException。
适用于
GetStringAsync(Uri)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (Uri requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri);member this.GetStringAsync : Uri -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As Uri) As Task(Of String)参数
- requestUri
- Uri
请求发送到的 URI。
返回
表示异步操作的任务对象。
例外
requestUri 必须为绝对 URI 或必须设置 BaseAddress。
由于基础问题（如网络连接性、DNS 失败、服务器证书验证或仅 .NET Framework 超时），请求失败。
仅限 .NET Core 和 .NET 5 及更高版本：请求因超时而失败。
注解
此操作不会阻止。 Task<TResult>返回的对象将在读取整个响应正文后完成。
注意
发生超时时：
- .NET Framework引发 HttpRequestException。
- .NET Core 引发 TaskCanceledException 没有任何内部异常。
- .NET 5 及更高版本引发嵌套 TaskCanceledException 的 TimeoutException。
适用于
GetStringAsync(String, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetStringAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of String)参数
- requestUri
- String
请求发送到的 URI。
- cancellationToken
- CancellationToken
用于取消操作的取消令牌。
返回
表示异步操作的任务对象。
例外
requestUri 为 null。
由于基础问题（如网络连接性、DNS 失败、服务器证书验证或仅 .NET Framework 超时），请求失败。
仅限 .NET Core 和 .NET 5 及更高版本：请求因超时而失败。
提供的请求 URI 是无效的相对 URI 或绝对 URI。
取消令牌已取消。 此异常存储在返回的任务中。
注解
此操作不会阻止。 Task<TResult>返回的对象将在读取整个响应正文后完成。
注意
发生超时时：
- .NET Framework引发 HttpRequestException。
- .NET Core 引发 TaskCanceledException 没有任何内部异常。
- .NET 5 及更高版本引发嵌套 TaskCanceledException 的 TimeoutException。
适用于
GetStringAsync(Uri, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetStringAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of String)参数
- requestUri
- Uri
请求发送到的 URI。
- cancellationToken
- CancellationToken
用于取消操作的取消令牌。
返回
表示异步操作的任务对象。
例外
requestUri 为 null。
由于基础问题（如网络连接性、DNS 失败、服务器证书验证或仅 .NET Framework 超时），请求失败。
仅限 .NET Core 和 .NET 5 及更高版本：请求因超时而失败。
取消令牌已取消。 此异常存储在返回的任务中。
注解
此操作不会阻止。 Task<TResult>返回的对象将在读取整个响应正文后完成。
注意
发生超时时：
- .NET Framework引发 HttpRequestException。
- .NET Core 引发 TaskCanceledException 没有任何内部异常。
- .NET 5 及更高版本引发嵌套 TaskCanceledException 的 TimeoutException。
