HttpClient.PutAsync Metoda

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.dll

Odešle požadavek PUT zadanému identifikátoru URI jako asynchronní operaci.

Přetížení

PutAsync(String, HttpContent)	Odešle požadavek PUT zadanému identifikátoru URI jako asynchronní operaci.
PutAsync(Uri, HttpContent)	Odešle požadavek PUT zadanému identifikátoru URI jako asynchronní operaci.
PutAsync(String, HttpContent, CancellationToken)	Odešlete požadavek PUT s tokenem zrušení jako asynchronní operaci.
PutAsync(Uri, HttpContent, CancellationToken)	Odešlete požadavek PUT s tokenem zrušení jako asynchronní operaci.

Poznámky

Tato operace nebude blokována.

PutAsync(String, HttpContent)

Zdroj:

HttpClient.cs

Odešle požadavek PUT zadanému identifikátoru URI jako asynchronní operaci.

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

Identifikátor URI, na který se požadavek odešle.

content

HttpContent

Obsah požadavku HTTP odeslaný na server.

Návraty

Task<HttpResponseMessage>

Objekt úlohy představující asynchronní operaci.

Výjimky

InvalidOperationException

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

HttpRequestException

Žá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.

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

UriFormatException

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.

PutAsync(Uri, HttpContent)

Zdroj:

HttpClient.cs

Odešle požadavek PUT zadanému identifikátoru URI jako asynchronní operaci.

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

Identifikátor URI, na který se požadavek odešle.

content

HttpContent

Obsah požadavku HTTP odeslaný na server.

Návraty

Task<HttpResponseMessage>

Objekt úlohy představující asynchronní operaci.

Výjimky

InvalidOperationException

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

HttpRequestException

Žá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.

TaskCanceledException

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.

PutAsync(String, HttpContent, CancellationToken)

Zdroj:

HttpClient.cs

Odešlete požadavek PUT s tokenem zrušení jako asynchronní operaci.

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

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

Task<HttpResponseMessage>

Objekt úlohy představující asynchronní operaci.

Výjimky

InvalidOperationException

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

HttpRequestException

Žá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.

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

UriFormatException

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

OperationCanceledException

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.

PutAsync(Uri, HttpContent, CancellationToken)

Zdroj:

HttpClient.cs

Odešlete požadavek PUT s tokenem zrušení jako asynchronní operaci.

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

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

Task<HttpResponseMessage>

Objekt úlohy představující asynchronní operaci.

Výjimky

InvalidOperationException

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

HttpRequestException

Žá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.

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

OperationCanceledException

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.