HttpClient.GetByteArrayAsync 方法

定义

将 GET 请求发送到指定 URI 并在异步操作中以字节数组的形式返回响应正文。

重载

GetByteArrayAsync(String)

将 GET 请求发送到指定 URI 并在异步操作中以字节数组的形式返回响应正文。

GetByteArrayAsync(Uri)

将 GET 请求发送到指定 URI 并在异步操作中以字节数组的形式返回响应正文。

GetByteArrayAsync(String, CancellationToken)

将 GET 请求发送到指定 URI 并在异步操作中以字节数组的形式返回响应正文。

GetByteArrayAsync(Uri, CancellationToken)

将 GET 请求发送到指定 URI 并在异步操作中以字节数组的形式返回响应正文。

注解

操作不会阻止。

GetByteArrayAsync(String)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

将 GET 请求发送到指定 URI 并在异步操作中以字节数组的形式返回响应正文。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri);
member this.GetByteArrayAsync : string -> System.Threading.Tasks.Task<byte[]>
Public Function GetByteArrayAsync (requestUri As String) As Task(Of Byte())

参数

requestUri
String

请求发送到的 URI。

返回

Task<Byte[]>

表示异步操作的任务对象。

例外

requestUri 必须为绝对 URI 或必须设置 BaseAddress

由于基础问题(如网络连接性、DNS 失败、服务器证书验证或超时),请求失败。

仅限 .NET Core 和 .NET 5 及更高版本:请求因超时而失败。

提供的请求 URI 是无效的相对 URI 或绝对 URI。

注解

此操作不会阻止。 Task<TResult>返回的对象将在读取整个响应正文后完成。

注意

如果出现超时,则会在不同的 .NET 实现上引发不同的异常。

适用于

GetByteArrayAsync(Uri)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

将 GET 请求发送到指定 URI 并在异步操作中以字节数组的形式返回响应正文。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri);
member this.GetByteArrayAsync : Uri -> System.Threading.Tasks.Task<byte[]>
Public Function GetByteArrayAsync (requestUri As Uri) As Task(Of Byte())

参数

requestUri
Uri

请求发送到的 URI。

返回

Task<Byte[]>

表示异步操作的任务对象。

例外

requestUri 必须为绝对 URI 或必须设置 BaseAddress

由于基础问题(如网络连接性、DNS 失败、服务器证书验证或仅 .NET Framework 超时),请求失败。

仅限 .NET Core 和 .NET 5 及更高版本:请求因超时而失败。

注解

此操作不会阻止。 Task<TResult>返回的对象将在读取整个响应正文后完成。

注意

发生超时时:

适用于

GetByteArrayAsync(String, CancellationToken)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

将 GET 请求发送到指定 URI 并在异步操作中以字节数组的形式返回响应正文。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetByteArrayAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
Public Function GetByteArrayAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Byte())

参数

requestUri
String

请求发送到的 URI。

cancellationToken
CancellationToken

用于取消操作的取消令牌。

返回

Task<Byte[]>

表示异步操作的任务对象。

例外

由于基础问题(如网络连接性、DNS 失败、服务器证书验证或仅 .NET Framework 超时),请求失败。

仅限 .NET Core 和 .NET 5 及更高版本:请求因超时而失败。

提供的请求 URI 是无效的相对 URI 或绝对 URI。

取消令牌已取消。 此异常存储在返回的任务中。

注解

此操作不会阻止。 Task<TResult>返回的对象将在读取整个响应正文后完成。

注意

发生超时时:

适用于

GetByteArrayAsync(Uri, CancellationToken)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

将 GET 请求发送到指定 URI 并在异步操作中以字节数组的形式返回响应正文。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetByteArrayAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
Public Function GetByteArrayAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Byte())

参数

requestUri
Uri

请求发送到的 URI。

cancellationToken
CancellationToken

用于取消操作的取消令牌。

返回

Task<Byte[]>

表示异步操作的任务对象。

例外

由于基础问题(如网络连接性、DNS 失败、服务器证书验证或仅 .NET Framework 超时),请求失败。

仅限 .NET Core 和 .NET 5 及更高版本:请求因超时而失败。

取消令牌已取消。 此异常存储在返回的任务中。

注解

此操作不会阻止。 Task<TResult>返回的对象将在读取整个响应正文后完成。

注意

发生超时时:

适用于