다음을 통해 공유


HttpClient.SendAsync 메서드

정의

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

오버로드

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

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

SendAsync(HttpRequestMessage)

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

SendAsync(HttpRequestMessage, HttpCompletionOption)

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

SendAsync(HttpRequestMessage, CancellationToken)

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

설명

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

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Source:
HttpClient.cs
Source:
HttpClient.cs
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

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

반환

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

예외

requestnull인 경우

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

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

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

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

설명

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

참고

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

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

적용 대상

SendAsync(HttpRequestMessage)

Source:
HttpClient.cs
Source:
HttpClient.cs
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 요청 메시지입니다.

반환

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

예외

requestnull인 경우

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

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

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

설명

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

참고

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

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

적용 대상

SendAsync(HttpRequestMessage, HttpCompletionOption)

Source:
HttpClient.cs
Source:
HttpClient.cs
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

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

반환

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

예외

requestnull인 경우

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

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

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

설명

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

참고

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

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

적용 대상

SendAsync(HttpRequestMessage, CancellationToken)

Source:
HttpClient.cs
Source:
HttpClient.cs
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

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

반환

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

예외

requestnull인 경우

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

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

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

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

설명

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

참고

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

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

적용 대상