다음을 통해 공유


HttpClient.PostAsync(Uri, IHttpContent) 메서드

정의

지정된 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)

매개 변수

uri
Uri Uri

요청이 전송되는 URI입니다.

content
IHttpContent

서버에 보낼 HTTP 요청 콘텐츠입니다.

반환

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

특성

예제

HttpClient.PostAsync를 호출하는 예제는 HttpClient를 참조하세요.

설명

이 작업은 차단되지 않습니다. 반환된 IAsyncOperationWithProgress (HttpResponseMessageHttpProgress)는 전체 응답(콘텐츠 포함)을 읽은 후 완료됩니다.

PostAsync 및 PutAsync 메서드는 제한된 수의 HTTP 콘텐츠 헤더만 설정할 수 있습니다. 반면 SendRequestAsync 메서드를 사용하면 요청 메시지와 HTTP 콘텐츠의 헤더를 전송할 수 있습니다.

다음은 이 함수가 throw하는 예외입니다.

E_INVALIDARG

uri 매개 변수는 null 참조(Visual Basic에서는 Nothing)였습니다.

예외 처리

이 메서드를 호출할 때 예외를 처리하는 코드를 작성해야 합니다. 매개 변수 유효성 검사 오류, 이름 확인 오류 및 네트워크 오류로 인해 예외가 발생할 수 있습니다. 네트워크 오류(예: 연결 손실, 연결 오류 및 HTTP 서버 오류)의 예외는 언제든지 발생할 수 있습니다. 이러한 오류로 인해 예외가 발생합니다. 앱에서 처리하지 않으면 예외로 인해 전체 앱이 런타임에 의해 종료될 수 있습니다. 예외를 처리하는 방법에 대한 자세한 내용은 네트워크 앱에서 예외 처리를 참조하세요.

적용 대상

추가 정보