HttpClient.DeleteAsync Methode

Definition

Namespace:: System.Net.Http

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Senden Sie eine DELETE-Anforderung als asynchronen Vorgang an den angegebenen URI.

Überlädt

Name	Beschreibung
DeleteAsync(String)	Senden Sie eine DELETE-Anforderung als asynchronen Vorgang an den angegebenen URI.
DeleteAsync(Uri)	Senden Sie eine DELETE-Anforderung als asynchronen Vorgang an den angegebenen URI.
DeleteAsync(String, CancellationToken)	Senden Sie eine DELETE-Anforderung an den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang.
DeleteAsync(Uri, CancellationToken)	Senden Sie eine DELETE-Anforderung an den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang.

DeleteAsync(String)

Senden Sie eine DELETE-Anforderung als asynchronen Vorgang an den angegebenen URI.

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)

Parameter

requestUri: String

Der URI, an den die Anforderung gesendet wird.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.

-oder-

Dies requestUri ist kein absoluter URI.

-oder-

BaseAddress ist nicht festgelegt.

HttpRequestException

Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. In .NET 8 und höheren Versionen wird der Grund durch HttpRequestError angegeben.

-oder-

.NET Framework: Timeout der Anforderung.

OperationCanceledException

.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.

Hinweise

Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde.

Note

Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst:

OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.

Gilt für:

DeleteAsync(Uri)

Senden Sie eine DELETE-Anforderung als asynchronen Vorgang an den angegebenen URI.

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)

Parameter

requestUri: Uri

Der URI, an den die Anforderung gesendet wird.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.

-oder-

Dies requestUri ist kein absoluter URI.

-oder-

BaseAddress ist nicht festgelegt.

HttpRequestException

Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError

-oder-

.NET Framework: Timeout der Anforderung.

OperationCanceledException

.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.

Hinweise

Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde.

Note

Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst:

OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.

Gilt für:

DeleteAsync(String, CancellationToken)

Senden Sie eine DELETE-Anforderung an den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang.

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)

Parameter

requestUri: String

Der URI, an den die Anforderung gesendet wird.

cancellationToken: CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.

-oder-

Dies requestUri ist kein absoluter URI.

-oder-

BaseAddress ist nicht festgelegt.

HttpRequestException

Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError

-oder-

.NET Framework: Timeout der Anforderung.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

-oder-

.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.

Hinweise

Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde.

Note

Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.

OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.

Gilt für:

DeleteAsync(Uri, CancellationToken)

Senden Sie eine DELETE-Anforderung an den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang.

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)

Parameter

requestUri: Uri

Der URI, an den die Anforderung gesendet wird.

cancellationToken: CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.

-oder-

Dies requestUri ist kein absoluter URI.

-oder-

BaseAddress ist nicht festgelegt.

HttpRequestException

Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError

-oder-

.NET Framework: Timeout der Anforderung.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

-oder-

.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.

Hinweise

Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde.

Note

Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.

HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.

OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.

OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.

Gilt für:

Feedback

War diese Seite hilfreich?