HttpClient.SendAsync 메서드

정의

네임스페이스:

System.Net.Http

어셈블리:

System.Net.Http.dll

HTTP 요청을 비동기 작업으로 보냅니다.

오버로드

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	HTTP 요청을 비동기 작업으로 보냅니다.
SendAsync(HttpRequestMessage)	HTTP 요청을 비동기 작업으로 보냅니다.
SendAsync(HttpRequestMessage, HttpCompletionOption)	HTTP 요청을 비동기 작업으로 보냅니다.
SendAsync(HttpRequestMessage, CancellationToken)	HTTP 요청을 비동기 작업으로 보냅니다.

설명

이 작업은 차단되지 않습니다.

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Source:

HttpClient.cs

HTTP 요청을 비동기 작업으로 보냅니다.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

매개 변수

request

HttpRequestMessage

보낼 HTTP 요청 메시지입니다.

completionOption

HttpCompletionOption

작업을 완료해야 할 경우(응답을 사용할 수 있게 된 즉시 또는 전체 응답 내용을 읽은 후).

cancellationToken

CancellationToken

작업을 취소할 취소 토큰입니다.

반환

Task<HttpResponseMessage>

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

예외

ArgumentNullException

request이 null인 경우

InvalidOperationException

요청 메시지를 HttpClient 인스턴스에서 이미 전송한 경우

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 작업은 차단되지 않습니다. 매개 변수의 completionOption 값에 따라 응답을 사용할 수 있거나 콘텐츠를 포함한 전체 응답을 읽는 즉시 반환 Task<TResult> 된 개체가 완료됩니다.

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

• HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
• TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
• TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Send(HttpRequestMessage, HttpCompletionOption)된 예외를 참조하세요.

SendAsync(HttpRequestMessage)

Source:

HttpClient.cs

HTTP 요청을 비동기 작업으로 보냅니다.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request);

override this.SendAsync : System.Net.Http.HttpRequestMessage -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function SendAsync (request As HttpRequestMessage) As Task(Of HttpResponseMessage)

매개 변수

request

HttpRequestMessage

보낼 HTTP 요청 메시지입니다.

반환

Task<HttpResponseMessage>

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

예외

ArgumentNullException

request이 null인 경우

InvalidOperationException

요청 메시지를 HttpClient 인스턴스에서 이미 전송한 경우

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 콘텐츠를 포함한 전체 응답을 읽은 후에 완료됩니다. 동작은 가 명시적으로 지정된 경우 ResponseContentRead 와 동일합니다.

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

• HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
• TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
• TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Send(HttpRequestMessage)된 예외를 참조하세요.

SendAsync(HttpRequestMessage, HttpCompletionOption)

Source:

HttpClient.cs

HTTP 요청을 비동기 작업으로 보냅니다.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);

override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

매개 변수

request

HttpRequestMessage

보낼 HTTP 요청 메시지입니다.

completionOption

HttpCompletionOption

작업을 완료해야 할 경우(응답을 사용할 수 있게 된 즉시 또는 전체 응답 내용을 읽은 후).

반환

Task<HttpResponseMessage>

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

예외

ArgumentNullException

request이 null인 경우

InvalidOperationException

요청 메시지를 HttpClient 인스턴스에서 이미 전송한 경우

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

설명

이 작업은 차단되지 않습니다. 매개 변수의 completionOption 값에 따라 응답을 사용할 수 있거나 콘텐츠를 포함한 전체 응답을 읽는 즉시 반환 Task<TResult> 된 개체가 완료됩니다.

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

• HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
• TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
• TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Send(HttpRequestMessage, HttpCompletionOption)된 예외를 참조하세요.

SendAsync(HttpRequestMessage, CancellationToken)

Source:

HttpClient.cs

HTTP 요청을 비동기 작업으로 보냅니다.

public:
 override System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);

override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Overrides Function SendAsync (request As HttpRequestMessage, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

매개 변수

request

HttpRequestMessage

보낼 HTTP 요청 메시지입니다.

cancellationToken

CancellationToken

작업을 취소할 취소 토큰입니다.

반환

Task<HttpResponseMessage>

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

예외

ArgumentNullException

request이 null인 경우

InvalidOperationException

요청 메시지를 HttpClient 인스턴스에서 이미 전송한 경우

HttpRequestException

네트워크 연결, DNS 오류, 서버 인증서 유효성 검사 또는 시간 초과와 같은 기본 문제로 인해 요청이 실패한 경우

TaskCanceledException

.NET Core 및 .NET 5 이상만 해당: 시간 제한으로 인해 요청이 실패했습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 콘텐츠를 포함한 전체 응답을 읽은 후에 완료됩니다. 동작은 가 명시적으로 지정된 경우 ResponseContentRead 와 동일합니다.

참고

시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.

• HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
• TaskCanceledException 모든 적용 가능한 .NET Core 버전에서 내부 예외가 throw되지 않습니다.
• TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Send(HttpRequestMessage)된 예외를 참조하세요.