HttpClient.PostAsync 메서드

참조

정의

네임스페이스:: System.Net.Http

어셈블리:: System.Net.Http.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

POST 요청을 지정된 URI에 비동기 작업으로 보냅니다.

오버로드

PostAsync(String, HttpContent, CancellationToken)	취소 토큰이 포함된 POST 요청을 비동기 작업으로 보냅니다.
PostAsync(Uri, HttpContent, CancellationToken)	취소 토큰이 포함된 POST 요청을 비동기 작업으로 보냅니다.
PostAsync(String, HttpContent)	POST 요청을 지정된 URI에 비동기 작업으로 보냅니다.
PostAsync(Uri, HttpContent)	POST 요청을 지정된 URI에 비동기 작업으로 보냅니다.

설명

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

PostAsync(String, HttpContent, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

취소 토큰이 포함된 POST 요청을 비동기 작업으로 보냅니다.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);

member this.PostAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PostAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

매개 변수

requestUri: String

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

content: HttpContent

서버로 전송된 HTTP 요청 콘텐츠입니다.

cancellationToken: CancellationToken

취소의 통지를 받기 위해 다른 개체나 스레드에서 사용할 수 있는 취소 토큰입니다.

반환

Task<HttpResponseMessage>

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

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

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

TaskCanceledException

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

UriFormatException

제공된 요청 URI가 유효한 상대 URI 또는 절대 URI가 아닙니다.

OperationCanceledException

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

설명

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

참고

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

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 내부 예외가 없으면 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

PostAsync(Uri, HttpContent, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

취소 토큰이 포함된 POST 요청을 비동기 작업으로 보냅니다.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);

member this.PostAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PostAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

매개 변수

requestUri: Uri

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

content: HttpContent

서버로 전송된 HTTP 요청 콘텐츠입니다.

cancellationToken: CancellationToken

취소의 통지를 받기 위해 다른 개체나 스레드에서 사용할 수 있는 취소 토큰입니다.

반환

Task<HttpResponseMessage>

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

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

설명

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

참고

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

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 내부 예외가 없으면 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

PostAsync(String, HttpContent)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

POST 요청을 지정된 URI에 비동기 작업으로 보냅니다.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content);

member this.PostAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PostAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)

매개 변수

requestUri: String

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

content: HttpContent

서버로 전송된 HTTP 요청 콘텐츠입니다.

반환

Task<HttpResponseMessage>

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

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

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

TaskCanceledException

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

UriFormatException

제공된 요청 URI가 유효한 상대 URI 또는 절대 URI가 아닙니다.

설명

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

참고

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

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 내부 예외가 없으면 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

PostAsync(Uri, HttpContent)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

POST 요청을 지정된 URI에 비동기 작업으로 보냅니다.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content);

member this.PostAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PostAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)

매개 변수

requestUri: Uri

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

content: HttpContent

서버로 전송된 HTTP 요청 콘텐츠입니다.

반환

Task<HttpResponseMessage>

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

예외

InvalidOperationException

requestUri가 절대 URI이거나 BaseAddress가 설정되어야 합니다.

HttpRequestException

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

TaskCanceledException

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

설명

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

참고

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

HttpRequestException는 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
TaskCanceledException 내부 예외가 없으면 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
TaskCanceledException 를 중첩하는 TimeoutException 는 .NET 5 이상 버전에서 throw됩니다.

적용 대상

다음을 통해 공유

HttpClient.PostAsync 메서드

정의

오버로드

설명

PostAsync(String, HttpContent, CancellationToken)

매개 변수

반환

예외

설명

적용 대상

PostAsync(Uri, HttpContent, CancellationToken)

매개 변수

반환

예외

설명

적용 대상

PostAsync(String, HttpContent)

매개 변수

반환

예외

설명

적용 대상

PostAsync(Uri, HttpContent)

매개 변수

반환

예외

설명

적용 대상

추가 리소스