HttpClient.GetStreamAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Verzend een GET-aanvraag naar de opgegeven URI en retourneer de hoofdtekst van het antwoord als een stroom in een asynchrone bewerking.
Overloads
| Name | Description |
|---|---|
| GetStreamAsync(Uri) |
Verzend een GET-aanvraag naar de opgegeven URI en retourneer de hoofdtekst van het antwoord als een stroom in een asynchrone bewerking. |
| GetStreamAsync(String) |
Verzend een GET-aanvraag naar de opgegeven URI en retourneer de hoofdtekst van het antwoord als een stroom in een asynchrone bewerking. |
Opmerkingen
De bewerking wordt niet geblokkeerd.
GetStreamAsync(Uri)
Verzend een GET-aanvraag naar de opgegeven URI en retourneer de hoofdtekst van het antwoord als een stroom in een asynchrone bewerking.
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)Parameters
- requestUri
- Uri
De URI waar de aanvraag naar wordt verzonden.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Het requestUri is geen absolute URI en BaseAddress is niet ingesteld.
De aanvraag is mislukt vanwege een probleem met het ophalen van een geldig HTTP-antwoord, zoals netwerkverbindingsfout, DNS-fout, servercertificaatvalidatiefout of ongeldige serverreactie. In .NET 8 en latere versies wordt de reden aangegeven door HttpRequestError
– of –
De antwoordstatuscode lag buiten het bereik van 200-299 (wat aangeeft dat de statuscode is geslaagd volgens de standaard).
– of –
alleen .NET Framework: er is een time-out opgetreden voor de aanvraag.
alleen .NET Core en .NET 5 en hoger: de aanvraag is mislukt vanwege een time-out.
Opmerkingen
Deze bewerking wordt niet geblokkeerd. Het geretourneerde taakstroomobject<> wordt voltooid nadat de antwoordheaders zijn gelezen. Met deze methode wordt de hoofdtekst van het antwoord niet gelezen of gebufferd.
Intern wordt deze bewerking gebruikt HttpResponseMessage.EnsureSuccessStatusCode om ervoor te zorgen dat de antwoordstatuscode zich in het bereik van het succes bevindt (200-299) en een HttpRequestException als dat niet het is.
In sommige scenario's hebt u mogelijk meer controle nodig over welke statuscodes als succesvol worden beschouwd; Er kan bijvoorbeeld worden verwacht dat een API altijd retourneert 200 OK. In dergelijke gevallen raden we u aan handmatig te controleren of StatusCode deze overeenkomt met de verwachte waarde.
Note
In het geval van een time-out:
- .NET Framework genereert een HttpRequestException.
- .NET Core genereert een OperationCanceledException zonder interne uitzondering.
- .NET 5 en latere versies gooien een OperationCanceledException die een TimeoutException nest.
Van toepassing op
GetStreamAsync(String)
Verzend een GET-aanvraag naar de opgegeven URI en retourneer de hoofdtekst van het antwoord als een stroom in een asynchrone bewerking.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::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)Parameters
- requestUri
- String
De URI waar de aanvraag naar wordt verzonden.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Het requestUri is geen absolute URI en BaseAddress is niet ingesteld.
De aanvraag is mislukt vanwege een probleem met het ophalen van een geldig HTTP-antwoord, zoals netwerkverbindingsfout, DNS-fout, servercertificaatvalidatiefout of ongeldige serverreactie. In .NET 8 en latere versies wordt de reden aangegeven door HttpRequestError
– of –
De antwoordstatuscode lag buiten het bereik van 200-299 (wat aangeeft dat de statuscode is geslaagd volgens de standaard).
– of –
alleen .NET Framework: er is een time-out opgetreden voor de aanvraag.
alleen .NET Core en .NET 5 en hoger: de aanvraag is mislukt vanwege een time-out.
De opgegeven aanvraag-URI is geen geldige relatieve of absolute URI.
Opmerkingen
Deze bewerking wordt niet geblokkeerd. Het geretourneerde taakstroomobject<> wordt voltooid nadat de antwoordheaders zijn gelezen. Met deze methode wordt de hoofdtekst van het antwoord niet gelezen of gebufferd.
Intern wordt deze bewerking gebruikt HttpResponseMessage.EnsureSuccessStatusCode om ervoor te zorgen dat de antwoordstatuscode zich in het bereik van het succes bevindt (200-299) en een HttpRequestException als dat niet het is.
In sommige scenario's hebt u mogelijk meer controle nodig over welke statuscodes als succesvol worden beschouwd; Er kan bijvoorbeeld worden verwacht dat een API altijd retourneert 200 OK. In dergelijke gevallen raden we u aan handmatig te controleren of StatusCode deze overeenkomt met de verwachte waarde.
Note
In het geval van een time-out:
- .NET Framework genereert een HttpRequestException.
- .NET Core genereert een OperationCanceledException zonder interne uitzondering.
- .NET 5 en latere versies gooien een OperationCanceledException die een TimeoutException nest.