HttpClient.PutAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 URI에 PUT 요청을 비동기 작업으로 보냅니다.
오버로드
| Name | Description |
|---|---|
| PutAsync(String, HttpContent) |
지정된 URI에 PUT 요청을 비동기 작업으로 보냅니다. |
| PutAsync(Uri, HttpContent) |
지정된 URI에 PUT 요청을 비동기 작업으로 보냅니다. |
| PutAsync(String, HttpContent, CancellationToken) |
취소 토큰을 사용하여 PUT 요청을 비동기 작업으로 보냅니다. |
| PutAsync(Uri, HttpContent, CancellationToken) |
취소 토큰을 사용하여 PUT 요청을 비동기 작업으로 보냅니다. |
설명
이 작업은 차단되지 않습니다.
PutAsync(String, HttpContent)
지정된 URI에 PUT 요청을 비동기 작업으로 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string requestUri, System.Net.Http.HttpContent content);member this.PutAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PutAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- String
요청이 전송되는 URI입니다.
- content
- HttpContent
서버로 전송된 HTTP 요청 콘텐츠입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
제공된 요청 URI가 유효한 상대 URI 또는 절대 URI가 아닙니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답(콘텐츠 포함)을 읽은 후에 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
PutAsync(Uri, HttpContent)
지정된 URI에 PUT 요청을 비동기 작업으로 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri requestUri, System.Net.Http.HttpContent content);member this.PutAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PutAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- Uri
요청이 전송되는 URI입니다.
- content
- HttpContent
서버로 전송된 HTTP 요청 콘텐츠입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답(콘텐츠 포함)을 읽은 후에 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
PutAsync(String, HttpContent, CancellationToken)
취소 토큰을 사용하여 PUT 요청을 비동기 작업으로 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);member this.PutAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PutAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- String
요청이 전송되는 URI입니다.
- content
- HttpContent
서버로 전송된 HTTP 요청 콘텐츠입니다.
- cancellationToken
- CancellationToken
다른 개체 또는 스레드에서 취소 알림을 받는 데 사용할 수 있는 취소 토큰입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
제공된 요청 URI가 유효한 상대 URI 또는 절대 URI가 아닙니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
-또는-
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답(콘텐츠 포함)을 읽은 후에 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.
적용 대상
PutAsync(Uri, HttpContent, CancellationToken)
취소 토큰을 사용하여 PUT 요청을 비동기 작업으로 보냅니다.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);member this.PutAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PutAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)매개 변수
- requestUri
- Uri
요청이 전송되는 URI입니다.
- content
- HttpContent
서버로 전송된 HTTP 요청 콘텐츠입니다.
- cancellationToken
- CancellationToken
다른 개체 또는 스레드에서 취소 알림을 받는 데 사용할 수 있는 취소 토큰입니다.
반품
비동기 작업을 나타내는 작업 개체입니다.
예외
절대 requestUri URI BaseAddress 가 아니며 설정되지 않았습니다.
네트워크 연결 오류, DNS 오류, 서버 인증서 유효성 검사 오류 또는 잘못된 서버 응답과 같은 유효한 HTTP 응답을 가져오는 문제로 인해 요청이 실패했습니다. .NET 8 이상 버전에서는 HttpRequestError
-또는-
.NET Framework만 해당: 요청 시간이 초과되었습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
-또는-
.NET Core 및 .NET 5 이상만: 시간 제한으로 인해 요청이 실패했습니다.
설명
이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 전체 응답(콘텐츠 포함)을 읽은 후에 완료됩니다.
메모
시간 제한의 경우 다른 .NET 구현에서 다른 예외가 throw됩니다.
- HttpRequestException 적용 가능한 모든 .NET Framework 버전에서 throw됩니다.
- 내부 예외가 없는 OperationCanceledException 적용 가능한 모든 .NET Core 버전에서 throw됩니다.
- TimeoutException 중첩하는 OperationCanceledException .NET 5 이상 버전에서 throw됩니다.