HttpClient.GetStreamAsync Methode

Definition

Namespace:: System.Net.Http

Assemblys:: netstandard.dll, System.Net.Http.dll

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 GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück.

Überlädt

Name	Beschreibung
GetStreamAsync(Uri, CancellationToken)	Senden Sie eine GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück.
GetStreamAsync(String, CancellationToken)	Senden Sie eine GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück.
GetStreamAsync(Uri)	Senden Sie eine GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück.
GetStreamAsync(String)	Senden Sie eine GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück.

Hinweise

Der Vorgang wird nicht blockiert.

GetStreamAsync(Uri, CancellationToken)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Senden Sie eine GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Stream)

Parameter

requestUri: Uri

Der URI, an den die Anforderung gesendet wird.

cancellationToken: CancellationToken

Das Abbruchtoken zum Abbrechen des Vorgangs.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentNullException

requestUri ist null.

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-

Der Antwortstatuscode lag außerhalb des Bereichs von 200-299 (was den Erfolg entsprechend dem Standard angibt).

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<Stream-Objekt> wird abgeschlossen, nachdem die Antwortheader gelesen wurden. Diese Methode liest oder puffert den Antworttext nicht. Intern wird dieser Vorgang verwendet HttpResponseMessage.EnsureSuccessStatusCode , um sicherzustellen, dass sich der Antwortstatuscode im Erfolgsbereich (200-299) befindet und wenn HttpRequestException dies nicht der Fall ist. In einigen Szenarien benötigen Sie möglicherweise mehr Kontrolle darüber, welche Statuscodes als erfolgreich betrachtet werden; Eine API kann z. B. erwartet werden, dass sie immer zurückgegeben 200 OKwird. In solchen Fällen wird empfohlen, manuell zu überprüfen, ob StatusCode der erwartete Wert übereinstimmt.

Note

Bei einem Timeout:

.NET Framework löst ein HttpRequestException aus.
.NET Core löst eine OperationCanceledException ohne innere Ausnahme aus.
.NET 5 und höhere Versionen lösen eine OperationCanceledException aus, die eine TimeoutException verschachtelt.

Gilt für:

GetStreamAsync(String, CancellationToken)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Senden Sie eine GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStreamAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Stream)

Parameter

requestUri: String

Der URI, an den die Anforderung gesendet wird.

cancellationToken: CancellationToken

Das Abbruchtoken zum Abbrechen des Vorgangs.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

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.

ArgumentNullException

requestUri ist null.

HttpRequestException

-oder-

Der Antwortstatuscode lag außerhalb des Bereichs von 200-299 (was den Erfolg entsprechend dem Standard angibt).

UriFormatException

Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.

Hinweise

Note

Bei einem Timeout:

.NET Framework löst ein HttpRequestException aus.
.NET Core löst eine OperationCanceledException ohne interne Ausnahme aus.
.NET 5 und neueren Versionen lösen eine OperationCanceledException aus, die eine TimeoutException verschachtelt.

Gilt für:

GetStreamAsync(Uri)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Senden Sie eine GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(Uri requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(Uri? requestUri);

member this.GetStreamAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As Uri) As Task(Of Stream)

Parameter

requestUri: Uri

Der URI, an den die Anforderung gesendet wird.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.

HttpRequestException

-oder-

Der Antwortstatuscode lag außerhalb des Bereichs von 200-299 (was den Erfolg entsprechend dem Standard angibt).

-oder-

.NET Framework: Timeout der Anforderung.

OperationCanceledException

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

Hinweise

Note

Bei einem Timeout:

.NET Framework löst ein HttpRequestException aus.
.NET Core löst eine OperationCanceledException ohne innere Ausnahme aus.
.NET 5 und höhere Versionen lösen eine OperationCanceledException aus, die eine TimeoutException verschachtelt.

Gilt für:

GetStreamAsync(String)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Senden Sie eine GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Datenstrom in einem asynchronen Vorgang zurück.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(string requestUri);

public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync(string? requestUri);

member this.GetStreamAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function GetStreamAsync (requestUri As String) As Task(Of Stream)

Parameter

requestUri: String

Der URI, an den die Anforderung gesendet wird.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.

HttpRequestException

-oder-

Der Antwortstatuscode lag außerhalb des Bereichs von 200-299 (was den Erfolg entsprechend dem Standard angibt).

-oder-

.NET Framework: Timeout der Anforderung.

OperationCanceledException

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

UriFormatException

Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.

Hinweise

Note

Bei einem Timeout:

.NET Framework löst ein HttpRequestException aus.
.NET Core löst eine OperationCanceledException ohne innere Ausnahme aus.
.NET 5 und höhere Versionen lösen eine OperationCanceledException aus, die eine TimeoutException verschachtelt.

Gilt für:

Feedback

War diese Seite hilfreich?