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