HttpClient.DeleteAsync Metoda

Definice

Obor názvů:

System.Net.Http

Sestavení:

netstandard.dll, System.Net.Http.dll

Odešle požadavek DELETE na zadaný identifikátor URI jako asynchronní operaci.

Přetížení

Name	Description
DeleteAsync(String)	Odešle požadavek DELETE na zadaný identifikátor URI jako asynchronní operaci.
DeleteAsync(Uri)	Odešle požadavek DELETE na zadaný identifikátor URI jako asynchronní operaci.
DeleteAsync(String, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.
DeleteAsync(Uri, CancellationToken)	Odešle požadavek DELETE na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.

DeleteAsync(String)

Zdroj:

HttpClient.cs

Odešle požadavek DELETE na zadaný identifikátor URI jako asynchronní operaci.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ DeleteAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> DeleteAsync(string? requestUri);

member this.DeleteAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function DeleteAsync (requestUri As String) As Task(Of HttpResponseMessage)

Parametry

requestUri

String

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

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Instance již odeslala HttpClient zprávu požadavku.

nebo

Nejedná se requestUri o absolutní identifikátor URI.

nebo

BaseAddress není nastavená.

HttpRequestException

Požadavek se nepovedl kvůli problému se získáním platné odpovědi HTTP, jako je selhání síťového připojení, selhání DNS, chyba ověření certifikátu serveru nebo neplatná odpověď serveru. Na .NET 8 a novějších verzích je důvod označen HttpRequestError.

nebo

pouze .NET Framework: Vypršel časový limit požadavku.

OperationCanceledException

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

Poznámky

Tato operace neblokuje. Vrácený Task<TResult> objekt se dokončí po přečtení celé odpovědi (včetně obsahu).

Note

V případě časového limitu se u různých implementací .NET vyvolá různé výjimky:

• OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.
• OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
• HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.

DeleteAsync(Uri)

Zdroj:

HttpClient.cs

Odešle požadavek DELETE na zadaný identifikátor URI jako asynchronní operaci.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ DeleteAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> DeleteAsync(Uri? requestUri);

member this.DeleteAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function DeleteAsync (requestUri As Uri) As Task(Of HttpResponseMessage)

Parametry

requestUri

Uri

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

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Instance již odeslala HttpClient zprávu požadavku.

nebo

Nejedná se requestUri o absolutní identifikátor URI.

nebo

BaseAddress není nastavená.

HttpRequestException

Požadavek se nepovedl kvůli problému se získáním platné odpovědi HTTP, jako je selhání síťového připojení, selhání DNS, chyba ověření certifikátu serveru nebo neplatná odpověď serveru. Na .NET 8 a novějších verzích je důvod označen HttpRequestError

nebo

.NET Framework: Vypršel časový limit požadavku.

OperationCanceledException

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

Poznámky

Tato operace neblokuje. Vrácený Task<TResult> objekt se dokončí po přečtení celé odpovědi (včetně obsahu).

Note

V případě časového limitu se u různých implementací .NET vyvolá různé výjimky:

• OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.
• OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
• HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.

DeleteAsync(String, CancellationToken)

Zdroj:

HttpClient.cs

Odešle požadavek DELETE na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.

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

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

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

Public Function DeleteAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametry

requestUri

String

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

cancellationToken

CancellationToken

Token zrušení, který lze použít jinými objekty nebo vlákny k přijetí oznámení o zrušení.

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Instance již odeslala HttpClient zprávu požadavku.

nebo

Nejedná se requestUri o absolutní identifikátor URI.

nebo

BaseAddress není nastavená.

HttpRequestException

Požadavek se nepovedl kvůli problému se získáním platné odpovědi HTTP, jako je selhání síťového připojení, selhání DNS, chyba ověření certifikátu serveru nebo neplatná odpověď serveru. Na .NET 8 a novějších verzích je důvod označen HttpRequestError

nebo

.NET Framework: Vypršel časový limit požadavku.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

nebo

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

Poznámky

Tato operace neblokuje. Vrácený Task<TResult> objekt se dokončí po přečtení celé odpovědi (včetně obsahu).

Note

V případě časového limitu se u různých implementací .NET vyvolá různé výjimky.

• OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.
• OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
• HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.

DeleteAsync(Uri, CancellationToken)

Zdroj:

HttpClient.cs

Odešle požadavek DELETE na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.

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

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

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

Public Function DeleteAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametry

requestUri

Uri

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

cancellationToken

CancellationToken

Token zrušení, který lze použít jinými objekty nebo vlákny k přijetí oznámení o zrušení.

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Instance již odeslala HttpClient zprávu požadavku.

nebo

Nejedná se requestUri o absolutní identifikátor URI.

nebo

BaseAddress není nastavená.

HttpRequestException

Požadavek se nepovedl kvůli problému se získáním platné odpovědi HTTP, jako je selhání síťového připojení, selhání DNS, chyba ověření certifikátu serveru nebo neplatná odpověď serveru. Na .NET 8 a novějších verzích je důvod označen HttpRequestError

nebo

.NET Framework: Vypršel časový limit požadavku.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

nebo

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

Poznámky

Tato operace neblokuje. Vrácený Task<TResult> objekt se dokončí po přečtení celé odpovědi (včetně obsahu).

Note

V případě časového limitu se u různých implementací .NET vyvolá různé výjimky.

• HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.
• OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
• OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.