HttpClient.PutAsync Methode
Definition
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 PUT-Anforderung als asynchronen Vorgang an den angegebenen URI.
Überlädt
| Name | Beschreibung |
|---|---|
| PutAsync(String, HttpContent) |
Senden Sie eine PUT-Anforderung als asynchronen Vorgang an den angegebenen URI. |
| PutAsync(Uri, HttpContent) |
Senden Sie eine PUT-Anforderung als asynchronen Vorgang an den angegebenen URI. |
| PutAsync(String, HttpContent, CancellationToken) |
Senden Sie eine PUT-Anforderung mit einem Abbruchtoken als asynchronen Vorgang. |
| PutAsync(Uri, HttpContent, CancellationToken) |
Senden Sie eine PUT-Anforderung mit einem Abbruchtoken als asynchronen Vorgang. |
Hinweise
Dieser Vorgang blockiert nicht.
PutAsync(String, HttpContent)
Senden Sie eine PUT-Anforderung als asynchronen Vorgang an den angegebenen URI.
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)Parameter
- requestUri
- String
Der URI, an den die Anforderung gesendet wird.
- content
- HttpContent
Der an den Server gesendete HTTP-Anforderungsinhalt.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
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.
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.
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:
PutAsync(Uri, HttpContent)
Senden Sie eine PUT-Anforderung als asynchronen Vorgang an den angegebenen URI.
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)Parameter
- requestUri
- Uri
Der URI, an den die Anforderung gesendet wird.
- content
- HttpContent
Der an den Server gesendete HTTP-Anforderungsinhalt.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
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.
.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:
PutAsync(String, HttpContent, CancellationToken)
Senden Sie eine PUT-Anforderung mit einem Abbruchtoken als asynchronen Vorgang.
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)Parameter
- requestUri
- String
Der URI, an den die Anforderung gesendet wird.
- content
- HttpContent
Der an den Server gesendete HTTP-Anforderungsinhalt.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
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.
Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.
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:
PutAsync(Uri, HttpContent, CancellationToken)
Senden Sie eine PUT-Anforderung mit einem Abbruchtoken als asynchronen Vorgang.
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)Parameter
- requestUri
- Uri
Der URI, an den die Anforderung gesendet wird.
- content
- HttpContent
Der an den Server gesendete HTTP-Anforderungsinhalt.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
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.
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.