HttpClient.GetByteArrayAsync 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 GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Bytearray in einem asynchronen Vorgang zurück.
Überlädt
| GetByteArrayAsync(String) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Antworttext in einem asynchronen Vorgang als Bytearray zurück. |
| GetByteArrayAsync(Uri) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Bytearray in einem asynchronen Vorgang zurück. |
| GetByteArrayAsync(String, CancellationToken) |
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Antworttext in einem asynchronen Vorgang als Bytearray zurück. |
| GetByteArrayAsync(Uri, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Bytearray in einem asynchronen Vorgang zurück. |
Hinweise
Der Vorgang wird nicht blockiert.
GetByteArrayAsync(String)
- Quelle:
- HttpClient.cs
- Quelle:
- HttpClient.cs
- Quelle:
- HttpClient.cs
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Antworttext in einem asynchronen Vorgang als Bytearray zurück.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string requestUri);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri);member this.GetByteArrayAsync : string -> System.Threading.Tasks.Task<byte[]>Public Function GetByteArrayAsync (requestUri As String) As Task(Of Byte())Parameter
- requestUri
- String
Der URI, an den die Anforderung gesendet wird.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.
Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.
Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.
Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der gesamte Antworttext gelesen wurde.
Hinweis
Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.
- HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
- TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen ausgelöst.
Gilt für:
GetByteArrayAsync(Uri)
- Quelle:
- HttpClient.cs
- Quelle:
- HttpClient.cs
- Quelle:
- HttpClient.cs
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Bytearray in einem asynchronen Vorgang zurück.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri requestUri);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri);member this.GetByteArrayAsync : Uri -> System.Threading.Tasks.Task<byte[]>Public Function GetByteArrayAsync (requestUri As Uri) As Task(Of Byte())Parameter
- requestUri
- Uri
Der URI, an den die Anforderung gesendet wird.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.
Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats (oder Timeout – nur .NET Framework) nicht durchgeführt werden.
Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der gesamte Antworttext gelesen wurde.
Hinweis
Im Falle eines Timeouts:
- .NET Framework löst ein ausHttpRequestException.
- .NET Core löst eine TaskCanceledException ohne innere Ausnahme aus.
- .NET 5 und höhere Versionen lösen eine aus TaskCanceledException , die einen TimeoutExceptionverschachtelt.
Gilt für:
GetByteArrayAsync(String, CancellationToken)
- Quelle:
- HttpClient.cs
- Quelle:
- HttpClient.cs
- Quelle:
- HttpClient.cs
Sendet eine GET-Anforderung an den angegebenen URI und gibt den Antworttext in einem asynchronen Vorgang als Bytearray zurück.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetByteArrayAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>Public Function GetByteArrayAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Byte())Parameter
- requestUri
- String
Der URI, an den die Anforderung gesendet wird.
- cancellationToken
- CancellationToken
Das Abbruchtoken, um den Vorgang abzubrechen.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats (oder Timeout – nur .NET Framework) nicht durchgeführt werden.
Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.
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.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der gesamte Antworttext gelesen wurde.
Hinweis
Im Falle eines Timeouts:
- .NET Framework löst ein ausHttpRequestException.
- .NET Core löst eine TaskCanceledException ohne innere Ausnahme aus.
- .NET 5 und höhere Versionen lösen eine aus TaskCanceledException , die einen TimeoutExceptionverschachtelt.
Gilt für:
GetByteArrayAsync(Uri, CancellationToken)
- Quelle:
- HttpClient.cs
- Quelle:
- HttpClient.cs
- Quelle:
- HttpClient.cs
Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Bytearray in einem asynchronen Vorgang zurück.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetByteArrayAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>Public Function GetByteArrayAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Byte())Parameter
- requestUri
- Uri
Der URI, an den die Anforderung gesendet wird.
- cancellationToken
- CancellationToken
Das Abbruchtoken, um den Vorgang abzubrechen.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats (oder Timeout – nur .NET Framework) nicht durchgeführt werden.
Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der gesamte Antworttext gelesen wurde.
Hinweis
Im Falle eines Timeouts:
- .NET Framework löst ein ausHttpRequestException.
- .NET Core löst eine TaskCanceledException ohne innere Ausnahme aus.
- .NET 5 und höhere Versionen lösen eine aus TaskCanceledException , die einen TimeoutExceptionverschachtelt.
