HttpClient.PostAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Odešle požadavek POST zadanému identifikátoru URI jako asynchronní operaci.
Přetížení
PostAsync(String, HttpContent, CancellationToken) |
Odešle požadavek POST s tokenem zrušení jako asynchronní operaci. |
PostAsync(Uri, HttpContent, CancellationToken) |
Odešle požadavek POST s tokenem zrušení jako asynchronní operaci. |
PostAsync(String, HttpContent) |
Odešle požadavek POST zadanému identifikátoru URI jako asynchronní operaci. |
PostAsync(Uri, HttpContent) |
Odešle požadavek POST zadanému identifikátoru URI jako asynchronní operaci. |
Poznámky
Tato operace nebude blokována.
PostAsync(String, HttpContent, CancellationToken)
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
Odešle požadavek POST s tokenem zrušení jako asynchronní operaci.
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)
Parametry
- requestUri
- String
Identifikátor URI, na který se požadavek odešle.
- content
- HttpContent
Obsah požadavku HTTP odeslaný na server.
- cancellationToken
- CancellationToken
Token zrušení, který může být použit jinými objekty nebo vlákny k přijetí oznámení o zrušení.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Musí requestUri
být absolutní identifikátor URI nebo BaseAddress musí být nastaven.
Žádost selhala kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.
Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.
Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.
Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.
Poznámky
Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celé odpovědi (včetně obsahu).
Poznámka
V případě vypršení časového limitu jsou v různých implementacích .NET vyvolány různé výjimky.
- HttpRequestException je vyvolán ve všech použitelných verzích rozhraní .NET Framework.
- TaskCanceledException ve všech použitelných verzích .NET Core se nevyvolá žádná vnitřní výjimka.
- TaskCanceledException která vnořuje TimeoutException objekt, je vyvolán v .NET 5 a novějších verzích.
Platí pro
PostAsync(Uri, HttpContent, CancellationToken)
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
Odešle požadavek POST s tokenem zrušení jako asynchronní operaci.
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)
Parametry
- requestUri
- Uri
Identifikátor URI, na který se požadavek odešle.
- content
- HttpContent
Obsah požadavku HTTP odeslaný na server.
- cancellationToken
- CancellationToken
Token zrušení, který může být použit jinými objekty nebo vlákny k přijetí oznámení o zrušení.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Musí requestUri
být absolutní identifikátor URI nebo BaseAddress musí být nastaven.
Žádost selhala kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.
Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.
Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.
Poznámky
Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celé odpovědi (včetně obsahu).
Poznámka
V případě vypršení časového limitu jsou v různých implementacích .NET vyvolány různé výjimky.
- HttpRequestException je vyvolán ve všech použitelných verzích rozhraní .NET Framework.
- TaskCanceledException ve všech použitelných verzích .NET Core se nevyvolá žádná vnitřní výjimka.
- TaskCanceledException která vnořuje TimeoutException objekt, je vyvolán v .NET 5 a novějších verzích.
Platí pro
PostAsync(String, HttpContent)
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
Odešle požadavek POST zadanému identifikátoru URI jako asynchronní operaci.
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)
Parametry
- requestUri
- String
Identifikátor URI, na který se požadavek odešle.
- content
- HttpContent
Obsah požadavku HTTP odeslaný na server.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Musí requestUri
být absolutní identifikátor URI nebo BaseAddress musí být nastaven.
Žádost selhala kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.
Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.
Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.
Poznámky
Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celé odpovědi (včetně obsahu).
Poznámka
V případě vypršení časového limitu jsou v různých implementacích .NET vyvolány různé výjimky.
- HttpRequestException je vyvolán ve všech použitelných verzích rozhraní .NET Framework.
- TaskCanceledException ve všech použitelných verzích .NET Core se nevyvolá žádná vnitřní výjimka.
- TaskCanceledException která vnořuje TimeoutException objekt, je vyvolán v .NET 5 a novějších verzích.
Platí pro
PostAsync(Uri, HttpContent)
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
Odešle požadavek POST zadanému identifikátoru URI jako asynchronní operaci.
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)
Parametry
- requestUri
- Uri
Identifikátor URI, na který se požadavek odešle.
- content
- HttpContent
Obsah požadavku HTTP odeslaný na server.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Musí requestUri
být absolutní identifikátor URI nebo BaseAddress musí být nastaven.
Žádost selhala kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.
Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.
Poznámky
Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celé odpovědi (včetně obsahu).
Poznámka
V případě vypršení časového limitu jsou v různých implementacích .NET vyvolány různé výjimky.
- HttpRequestException je vyvolán ve všech použitelných verzích rozhraní .NET Framework.
- TaskCanceledException ve všech použitelných verzích .NET Core se nevyvolá žádná vnitřní výjimka.
- TaskCanceledException která vnořuje TimeoutException objekt, je vyvolán v .NET 5 a novějších verzích.