HttpClient.SendRequestAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| SendRequestAsync(HttpRequestMessage) |
HTTP 요청을 비동기 작업으로 보냅니다. HttpClient 클래스 및 코드 예제에 대한 프로그래밍 지침은 HttpClient 개념 항목을 참조하세요. |
| SendRequestAsync(HttpRequestMessage, HttpCompletionOption) |
비동기 작업으로 HTTP 완료 옵션을 사용하여 HTTP 요청을 보냅니다. HttpClient 클래스 및 코드 예제에 대한 프로그래밍 지침은 HttpClient 개념 항목을 참조하세요. |
SendRequestAsync(HttpRequestMessage)
HTTP 요청을 비동기 작업으로 보냅니다. HttpClient 클래스 및 코드 예제에 대한 프로그래밍 지침은 HttpClient 개념 항목을 참조하세요.
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request) = SendRequestAsync;/// [Windows.Foundation.Metadata.Overload("SendRequestAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request);[Windows.Foundation.Metadata.Overload("SendRequestAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request);function sendRequestAsync(request)Public Function SendRequestAsync (request As HttpRequestMessage) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)매개 변수
- request
- HttpRequestMessage
보낼 HTTP 요청 메시지입니다.
반환
비동기 작업을 나타내는 개체입니다.
- 특성
설명
이 작업은 차단되지 않습니다. 반환된 IAsyncOperationWithProgress ( HttpResponseMessage 및 HttpProgress)는 전체 응답(콘텐츠 포함)을 읽은 후 완료됩니다.
요청 매개 변수에 전달된 HttpRequestMessage를 사용하면 SendRequestAsync 메서드가 전송할 HTTP 콘텐츠뿐만 아니라 요청 메시지의 헤더를 설정할 수 있습니다. 반면 PostAsync 및 PutAsync 메서드는 더 제한된 HTTP 콘텐츠 헤더 집합만 설정할 수 있습니다.
다음은 이 함수가 throw하는 예외입니다.
E_ILLEGAL_METHOD_CALL
요청 메시지는 HttpClient instance 이미 전송되었습니다.
예외 처리
이 메서드를 호출할 때 예외를 처리하는 코드를 작성해야 합니다. 매개 변수 유효성 검사 오류, 이름 확인 실패 및 네트워크 오류로 인해 예외가 발생할 수 있습니다. 네트워크 오류(예: 연결 손실, 연결 오류 및 HTTP 서버 오류)의 예외는 언제든지 발생할 수 있습니다. 이러한 오류로 인해 예외가 발생합니다. 앱에서 처리하지 않으면 예외로 인해 런타임에 의해 전체 앱이 종료될 수 있습니다. 예외를 처리하는 방법에 대한 자세한 내용은 네트워크 앱에서 예외 처리 및 방법: HRESULT 및 예외 매핑을 참조하세요.
추가 정보
- HttpRequestMessage
- PostAsync(Uri, IHttpContent)
- PutAsync(Uri, IHttpContent)
- SendRequestAsync(HttpRequestMessage, HttpCompletionOption)
- HttpClient
적용 대상
SendRequestAsync(HttpRequestMessage, HttpCompletionOption)
비동기 작업으로 HTTP 완료 옵션을 사용하여 HTTP 요청을 보냅니다. HttpClient 클래스 및 코드 예제에 대한 프로그래밍 지침은 HttpClient 개념 항목을 참조하세요.
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request, HttpCompletionOption completionOption) = SendRequestAsync;/// [Windows.Foundation.Metadata.Overload("SendRequestWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request, HttpCompletionOption const& completionOption);[Windows.Foundation.Metadata.Overload("SendRequestWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request, HttpCompletionOption completionOption);function sendRequestAsync(request, completionOption)Public Function SendRequestAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)매개 변수
- request
- HttpRequestMessage
보낼 HTTP 요청 메시지입니다.
- completionOption
- HttpCompletionOption
모든 응답을 읽을 때 또는 헤더만 읽을 때 HttpClient 작업이 완료된 것으로 간주되는지 여부를 나타내는 값입니다.
반환
비동기 작업을 나타내는 개체입니다.
- 특성
설명
이 작업은 차단되지 않습니다. 반환된 IAsyncOperationWithProgress ( HttpResponseMessage 및 HttpProgress)는 completionOption 매개 변수의 값에 따라 완료됩니다.
요청 매개 변수에 전달된 HttpRequestMessage를 사용하면 SendRequestAsync 메서드가 전송할 HTTP 콘텐츠뿐만 아니라 요청 메시지의 헤더를 설정할 수 있습니다. 반면 PostAsync 및 PutAsync 메서드는 더 제한된 HTTP 콘텐츠 헤더 집합만 설정할 수 있습니다.
다음은 이 함수가 throw하는 예외입니다.
E_ILLEGAL_METHOD_CALL
요청 메시지는 HttpClient instance 이미 전송되었습니다.
예외 처리
이 메서드를 호출할 때 예외를 처리하는 코드를 작성해야 합니다. 매개 변수 유효성 검사 오류, 이름 확인 실패 및 네트워크 오류로 인해 예외가 발생할 수 있습니다. 네트워크 오류(예: 연결 손실, 연결 오류 및 HTTP 서버 오류)의 예외는 언제든지 발생할 수 있습니다. 이러한 오류로 인해 예외가 발생합니다. 앱에서 처리하지 않으면 예외로 인해 런타임에 의해 전체 앱이 종료될 수 있습니다. 예외를 처리하는 방법에 대한 자세한 내용은 네트워크 앱에서 예외 처리 및 방법: HRESULT 및 예외 매핑을 참조하세요.