HttpClient.PutAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wyślij żądanie PUT do określonego identyfikatora URI jako operację asynchroniczną.
Przeciążenia
| Nazwa | Opis |
|---|---|
| PutAsync(String, HttpContent) |
Wyślij żądanie PUT do określonego identyfikatora URI jako operację asynchroniczną. |
| PutAsync(Uri, HttpContent) |
Wyślij żądanie PUT do określonego identyfikatora URI jako operację asynchroniczną. |
| PutAsync(String, HttpContent, CancellationToken) |
Wyślij żądanie PUT z tokenem anulowania jako operację asynchroniczną. |
| PutAsync(Uri, HttpContent, CancellationToken) |
Wyślij żądanie PUT z tokenem anulowania jako operację asynchroniczną. |
Uwagi
Ta operacja nie blokuje.
PutAsync(String, HttpContent)
Wyślij żądanie PUT do określonego identyfikatora URI jako operację asynchroniczną.
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)Parametry
- requestUri
- String
Identyfikator URI, do którego jest wysyłane żądanie.
- content
- HttpContent
Zawartość żądania HTTP wysłana na serwer.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Nie requestUri jest to bezwzględny identyfikator URI i BaseAddress nie jest ustawiony.
Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError
— lub —
tylko .NET Framework: upłynął limit czasu żądania.
.NET Core i .NET 5 i nowszych tylko: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
Podany identyfikator URI żądania jest nieprawidłowy względny lub bezwzględny identyfikator URI.
Uwagi
Ta operacja nie blokuje. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi (w tym zawartości).
Uwaga / Notatka
W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach .NET.
- HttpRequestException jest zgłaszany we wszystkich odpowiednich wersjach programu .NET Framework.
- OperationCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach .NET Core.
- OperationCanceledException, który zagnieżdża TimeoutException jest zgłaszany w .NET 5 lub nowszych wersjach.
Dotyczy
PutAsync(Uri, HttpContent)
Wyślij żądanie PUT do określonego identyfikatora URI jako operację asynchroniczną.
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)Parametry
- requestUri
- Uri
Identyfikator URI, do którego jest wysyłane żądanie.
- content
- HttpContent
Zawartość żądania HTTP wysłana na serwer.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Nie requestUri jest to bezwzględny identyfikator URI i BaseAddress nie jest ustawiony.
Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError
— lub —
tylko .NET Framework: upłynął limit czasu żądania.
.NET Core i .NET 5 i nowszych tylko: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
Uwagi
Ta operacja nie blokuje. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi (w tym zawartości).
Uwaga / Notatka
W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach .NET.
- HttpRequestException jest zgłaszany we wszystkich odpowiednich wersjach programu .NET Framework.
- OperationCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach .NET Core.
- OperationCanceledException, który zagnieżdża TimeoutException jest zgłaszany w .NET 5 lub nowszych wersjach.
Dotyczy
PutAsync(String, HttpContent, CancellationToken)
Wyślij żądanie PUT z tokenem anulowania jako operację asynchroniczną.
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)Parametry
- requestUri
- String
Identyfikator URI, do którego jest wysyłane żądanie.
- content
- HttpContent
Zawartość żądania HTTP wysłana na serwer.
- cancellationToken
- CancellationToken
Token anulowania, który może być używany przez inne obiekty lub wątki do otrzymywania powiadomienia o anulowaniu.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Nie requestUri jest to bezwzględny identyfikator URI i BaseAddress nie jest ustawiony.
Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError
— lub —
tylko .NET Framework: upłynął limit czasu żądania.
Podany identyfikator URI żądania jest nieprawidłowy względny lub bezwzględny identyfikator URI.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
— lub —
.NET Core i .NET 5 i nowszych tylko: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
Uwagi
Ta operacja nie blokuje. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi (w tym zawartości).
Uwaga / Notatka
W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach .NET.
- HttpRequestException jest zgłaszany we wszystkich odpowiednich wersjach programu .NET Framework.
- OperationCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach .NET Core.
- OperationCanceledException, który zagnieżdża TimeoutException jest zgłaszany w .NET 5 lub nowszych wersjach.
Dotyczy
PutAsync(Uri, HttpContent, CancellationToken)
Wyślij żądanie PUT z tokenem anulowania jako operację asynchroniczną.
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)Parametry
- requestUri
- Uri
Identyfikator URI, do którego jest wysyłane żądanie.
- content
- HttpContent
Zawartość żądania HTTP wysłana na serwer.
- cancellationToken
- CancellationToken
Token anulowania, który może być używany przez inne obiekty lub wątki do otrzymywania powiadomienia o anulowaniu.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Nie requestUri jest to bezwzględny identyfikator URI i BaseAddress nie jest ustawiony.
Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError
— lub —
tylko .NET Framework: upłynął limit czasu żądania.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
— lub —
.NET Core i .NET 5 i nowszych tylko: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
Uwagi
Ta operacja nie blokuje. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi (w tym zawartości).
Uwaga / Notatka
W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach .NET.
- HttpRequestException jest zgłaszany we wszystkich odpowiednich wersjach programu .NET Framework.
- OperationCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach .NET Core.
- OperationCanceledException, który zagnieżdża TimeoutException jest zgłaszany w .NET 5 lub nowszych wersjach.