HttpClient.Send Methode

Definition

Überlädt

Name Beschreibung
Send(HttpRequestMessage)

Sendet eine HTTP-Anforderung mit der angegebenen Anforderung.

Send(HttpRequestMessage, HttpCompletionOption)

Sendet eine HTTP-Anforderung.

Send(HttpRequestMessage, CancellationToken)

Sendet eine HTTP-Anforderung mit dem angegebenen Anforderungs- und Abbruchtoken.

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Sendet eine HTTP-Anforderung mit dem angegebenen Anforderungs-, Abschluss- und Abbruchtoken.

Send(HttpRequestMessage)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Sendet eine HTTP-Anforderung mit der angegebenen Anforderung.

public:
 System::Net::Http::HttpResponseMessage ^ Send(System::Net::Http::HttpRequestMessage ^ request);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request);
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage -> System.Net.Http.HttpResponseMessage
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
override this.Send : System.Net.Http.HttpRequestMessage -> System.Net.Http.HttpResponseMessage
override this.Send : System.Net.Http.HttpRequestMessage -> System.Net.Http.HttpResponseMessage
Public Function Send (request As HttpRequestMessage) As HttpResponseMessage

Parameter

request
HttpRequestMessage

Die zu sendende HTTP-Anforderungsnachricht.

Gibt zurück

Eine HTTP-Antwortnachricht.

Attribute

Ausnahmen

request ist null.

Die HTTP-Version ist 2.0 oder höher, oder die Versionsrichtlinie ist auf .RequestVersionOrHigher

-oder-

Die von der Methode abgeleitete HttpContent benutzerdefinierte Klasse überschreibt die SerializeToStream(Stream, TransportContext, CancellationToken) Methode nicht.

-oder-

Die benutzerdefinierte Methode HttpMessageHandler überschreibt die Send(HttpRequestMessage, CancellationToken) Methode nicht.

Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.

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.

Wenn die OperationCanceledException Ausnahme die TimeoutException: Die Anforderung aufgrund eines Timeouts fehlgeschlagen ist.

Gilt für:

Send(HttpRequestMessage, HttpCompletionOption)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Sendet eine HTTP-Anforderung.

public:
 System::Net::Http::HttpResponseMessage ^ Send(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Net.Http.HttpResponseMessage
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Net.Http.HttpResponseMessage
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Net.Http.HttpResponseMessage
Public Function Send (request As HttpRequestMessage, completionOption As HttpCompletionOption) As HttpResponseMessage

Parameter

request
HttpRequestMessage

Die zu sendende HTTP-Anforderungsnachricht.

completionOption
HttpCompletionOption

Einer der Enumerationswerte, der angibt, wann der Vorgang abgeschlossen werden soll (sobald eine Antwort verfügbar ist oder nachdem der Antwortinhalt gelesen wurde).

Gibt zurück

Die HTTP-Antwortnachricht.

Attribute

Ausnahmen

request ist null.

Die HTTP-Version ist 2.0 oder höher, oder die Versionsrichtlinie ist auf .RequestVersionOrHigher

-oder-

Die von der Methode abgeleitete HttpContent benutzerdefinierte Klasse überschreibt die SerializeToStream(Stream, TransportContext, CancellationToken) Methode nicht.

-oder-

Die benutzerdefinierte Methode HttpMessageHandler überschreibt die Send(HttpRequestMessage, CancellationToken) Methode nicht.

Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.

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.

Wenn die OperationCanceledException Ausnahme die TimeoutException: Die Anforderung aufgrund eines Timeouts fehlgeschlagen ist.

Gilt für:

Send(HttpRequestMessage, CancellationToken)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Sendet eine HTTP-Anforderung mit dem angegebenen Anforderungs- und Abbruchtoken.

public:
 override System::Net::Http::HttpResponseMessage ^ Send(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public override System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public override System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);
public override System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage
override this.Send : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage
Public Overrides Function Send (request As HttpRequestMessage, cancellationToken As CancellationToken) As HttpResponseMessage

Parameter

request
HttpRequestMessage

Die zu sendende HTTP-Anforderungsnachricht.

cancellationToken
CancellationToken

Das Token zum Abbrechen des Vorgangs.

Gibt zurück

Die HTTP-Antwortnachricht.

Attribute

Ausnahmen

request ist null.

Die HTTP-Version ist 2.0 oder höher, oder die Versionsrichtlinie ist auf .RequestVersionOrHigher

-oder-

Die von der Methode abgeleitete HttpContent benutzerdefinierte Klasse überschreibt die SerializeToStream(Stream, TransportContext, CancellationToken) Methode nicht.

-oder-

Die benutzerdefinierte Methode HttpMessageHandler überschreibt die Send(HttpRequestMessage, CancellationToken) Methode nicht.

Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.

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.

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.

Gilt für:

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Sendet eine HTTP-Anforderung mit dem angegebenen Anforderungs-, Abschluss- und Abbruchtoken.

public:
 System::Net::Http::HttpResponseMessage ^ Send(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage
Public Function Send (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As HttpResponseMessage

Parameter

request
HttpRequestMessage

Die zu sendende HTTP-Anforderungsnachricht.

completionOption
HttpCompletionOption

Einer der Enumerationswerte, der angibt, wann der Vorgang abgeschlossen werden soll (sobald eine Antwort verfügbar ist oder nachdem der Antwortinhalt gelesen wurde).

cancellationToken
CancellationToken

Das Token zum Abbrechen des Vorgangs.

Gibt zurück

Die HTTP-Antwortnachricht.

Attribute

Ausnahmen

request ist null.

Die HTTP-Version ist 2.0 oder höher, oder die Versionsrichtlinie ist auf .RequestVersionOrHigher

-oder-

Die von der Methode abgeleitete HttpContent benutzerdefinierte Klasse überschreibt die SerializeToStream(Stream, TransportContext, CancellationToken) Methode nicht.

-oder-

Die benutzerdefinierte Methode HttpMessageHandler überschreibt die Send(HttpRequestMessage, CancellationToken) Methode nicht.

Die Anforderungsnachricht wurde bereits von der HttpClient Instanz gesendet.

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.

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.

Gilt für: