HttpClient.GetByteArrayAsync 메서드

정의

GET 요청을 지정된 URI에 보내고 비동기 작업에서 바이트 배열로 응답 본문을 반환합니다.Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.

오버로드

GetByteArrayAsync(String)

GET 요청을 지정된 URI에 보내고 비동기 작업에서 바이트 배열로 응답 본문을 반환합니다.Sends a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.

GetByteArrayAsync(Uri)

GET 요청을 지정된 URI에 보내고 비동기 작업에서 바이트 배열로 응답 본문을 반환합니다.Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.

GetByteArrayAsync(String, CancellationToken)

GET 요청을 지정된 URI에 보내고 비동기 작업에서 바이트 배열로 응답 본문을 반환합니다.Sends a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.

GetByteArrayAsync(Uri, CancellationToken)

GET 요청을 지정된 URI에 보내고 비동기 작업에서 바이트 배열로 응답 본문을 반환합니다.Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.

설명

작업은 차단 되지 않습니다.The operation will not block.

GetByteArrayAsync(String)

GET 요청을 지정된 URI에 보내고 비동기 작업에서 바이트 배열로 응답 본문을 반환합니다.Sends a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.

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입니다.The Uri the request is sent to.

반환

Task<Byte[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.The task object representing the asynchronous operation.

예외

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.The requestUri must be an absolute URI or BaseAddress must be set.

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

.NET Core 및 .NET 5.0 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다..NET Core and .NET 5.0 and later only: The request failed due to timeout.

설명

이 작업은 차단 되지 않습니다.This operation will not block. 반환 된 Task<TResult> 개체는 전체 응답 본문을 읽은 후에 완료 됩니다.The returned Task<TResult> object will complete after the whole response body is read.

참고

시간 초과가 발생 하는 경우 서로 다른 .NET 구현에서 다른 예외가 throw 됩니다.In case of timeout, different exceptions are thrown on different .NET implementations.

적용 대상

GetByteArrayAsync(Uri)

GET 요청을 지정된 URI에 보내고 비동기 작업에서 바이트 배열로 응답 본문을 반환합니다.Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.

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입니다.The Uri the request is sent to.

반환

Task<Byte[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.The task object representing the asynchronous operation.

예외

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.The requestUri must be an absolute URI or BaseAddress must be set.

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사(또는 .NET Framework의 경우에만 시간 초과)와 같은 기본 문제로 인해 요청이 실패했습니다.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only).

.NET Core 및 .NET 5.0 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다..NET Core and .NET 5.0 and later only: The request failed due to timeout.

설명

이 작업은 차단 되지 않습니다.This operation will not block. 반환 된 Task<TResult> 개체는 전체 응답 본문을 읽은 후에 완료 됩니다.The returned Task<TResult> object will complete after the whole response body is read.

참고

시간 제한의 경우:In case of a timeout:

적용 대상

GetByteArrayAsync(String, CancellationToken)

GET 요청을 지정된 URI에 보내고 비동기 작업에서 바이트 배열로 응답 본문을 반환합니다.Sends a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.

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입니다.The Uri the request is sent to.

cancellationToken
CancellationToken

작업을 취소할 취소 토큰입니다.The cancellation token to cancel the operation.

반환

Task<Byte[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.The task object representing the asynchronous operation.

예외

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사(또는 .NET Framework의 경우에만 시간 초과)와 같은 기본 문제로 인해 요청이 실패했습니다.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only).

.NET Core 및 .NET 5.0 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다..NET Core and .NET 5.0 and later only: The request failed due to timeout.

설명

이 작업은 차단 되지 않습니다.This operation will not block. 반환 된 Task<TResult> 개체는 전체 응답 본문을 읽은 후에 완료 됩니다.The returned Task<TResult> object will complete after the whole response body is read.

참고

시간 제한의 경우:In case of a timeout:

적용 대상

GetByteArrayAsync(Uri, CancellationToken)

GET 요청을 지정된 URI에 보내고 비동기 작업에서 바이트 배열로 응답 본문을 반환합니다.Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.

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입니다.The Uri the request is sent to.

cancellationToken
CancellationToken

작업을 취소할 취소 토큰입니다.The cancellation token to cancel the operation.

반환

Task<Byte[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.The task object representing the asynchronous operation.

예외

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사(또는 .NET Framework의 경우에만 시간 초과)와 같은 기본 문제로 인해 요청이 실패했습니다.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only).

.NET Core 및 .NET 5.0 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다..NET Core and .NET 5.0 and later only: The request failed due to timeout.

설명

이 작업은 차단 되지 않습니다.This operation will not block. 반환 된 Task<TResult> 개체는 전체 응답 본문을 읽은 후에 완료 됩니다.The returned Task<TResult> object will complete after the whole response body is read.

참고

시간 제한의 경우:In case of a timeout:

적용 대상