HttpClient.SendAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
HTTP 요청을 비동기 작업으로 보냅니다.
오버로드
| Name | Description |
|---|---|
| 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
- 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
취소 작업을 취소할 취소 토큰입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
request은 null입니다.
요청 메시지가 인스턴스에서 이미 전송되었습니다 HttpClient .
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
-또는-
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 매개 변수 값 completionOption 에 따라 반환 Task<TResult> 된 개체는 응답을 사용할 수 있거나 콘텐츠를 포함한 전체 응답을 읽는 즉시 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- OperationCanceledException 중첩하는 TimeoutException .NET 5 이상 버전에서 throw됩니다.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 Send(HttpRequestMessage, HttpCompletionOption)throw된 예외를 참조하세요.
적용 대상
SendAsync(HttpRequestMessage)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- 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 요청 메시지입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
request은 null입니다.
요청 메시지가 인스턴스에서 이미 전송되었습니다 HttpClient .
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 콘텐츠를 포함한 전체 응답을 읽은 후에 완료됩니다. 동작은 명시적으로 지정된 경우 ResponseContentRead 와 동일합니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- OperationCanceledException 중첩하는 TimeoutException .NET 5 이상 버전에서 throw됩니다.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 Send(HttpRequestMessage)throw된 예외를 참조하세요.
적용 대상
SendAsync(HttpRequestMessage, HttpCompletionOption)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- 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
작업이 완료되어야 하는 경우(응답을 사용할 수 있는 즉시 또는 전체 응답 콘텐츠를 읽은 후)
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
request은 null입니다.
요청 메시지가 인스턴스에서 이미 전송되었습니다 HttpClient .
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 매개 변수 값 completionOption 에 따라 반환 Task<TResult> 된 개체는 응답을 사용할 수 있거나 콘텐츠를 포함한 전체 응답을 읽는 즉시 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- OperationCanceledException 중첩하는 TimeoutException .NET 5 이상 버전에서 throw됩니다.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 Send(HttpRequestMessage, HttpCompletionOption)throw된 예외를 참조하세요.
적용 대상
SendAsync(HttpRequestMessage, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- 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
취소 작업을 취소할 취소 토큰입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
request은 null입니다.
요청 메시지가 인스턴스에서 이미 전송되었습니다 HttpClient .
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
-또는-
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 콘텐츠를 포함한 전체 응답을 읽은 후에 완료됩니다. 동작은 명시적으로 지정된 경우 ResponseContentRead 와 동일합니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- OperationCanceledException 중첩하는 TimeoutException .NET 5 이상 버전에서 throw됩니다.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 Send(HttpRequestMessage)throw된 예외를 참조하세요.
