HttpContent.ReadAsStreamAsync 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.
Serialisiert den HTTP-Inhalt und gibt einen Datenstrom zurück, der den Inhalt darstellt.
Überlädt
| ReadAsStreamAsync() |
Serialisieren Sie den HTTP-Inhalt, und geben Sie einen Datenstrom zurück, der den Inhalt als asynchronen Vorgang darstellt. |
| ReadAsStreamAsync(CancellationToken) |
Serialisieren Sie den HTTP-Inhalt, und geben Sie einen Datenstrom zurück, der den Inhalt als asynchronen Vorgang darstellt. |
Hinweise
Beachten Sie, dass diese Methode den Inhalt intern puffert, es sei denn, CreateContentReadStreamAsync() anderweitig implementiert wurde.
ReadAsStreamAsync()
- Quelle:
- HttpContent.cs
- Quelle:
- HttpContent.cs
- Quelle:
- HttpContent.cs
Serialisieren Sie den HTTP-Inhalt, und geben Sie einen Datenstrom zurück, der den Inhalt als asynchronen Vorgang darstellt.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ ReadAsStreamAsync();public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync ();member this.ReadAsStreamAsync : unit -> System.Threading.Tasks.Task<System.IO.Stream>Public Function ReadAsStreamAsync () As Task(Of Stream)Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult>-Objekt wird abgeschlossen, nachdem der gesamte Datenstrom, der Den Inhalt darstellt, gelesen wurde.
Nach Abschluss des Vorgangs enthält die Result-Eigenschaft des zurückgegebenen Aufgabenobjekts den Datenstrom, der den HTTP-Inhalt darstellt. Der zurückgegebene Datenstrom kann dann zum Lesen des Inhalts mithilfe verschiedener Stream-APIs verwendet werden.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungs exceptions, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von ReadAsStream()ausgelösten Ausnahmen.
Gilt für:
ReadAsStreamAsync(CancellationToken)
- Quelle:
- HttpContent.cs
- Quelle:
- HttpContent.cs
- Quelle:
- HttpContent.cs
Serialisieren Sie den HTTP-Inhalt, und geben Sie einen Datenstrom zurück, der den Inhalt als asynchronen Vorgang darstellt.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ ReadAsStreamAsync(System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync (System.Threading.CancellationToken cancellationToken);member this.ReadAsStreamAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>Public Function ReadAsStreamAsync (cancellationToken As CancellationToken) As Task(Of Stream)Parameter
- cancellationToken
- CancellationToken
Das Abbruchtoken zum Abbrechen des Vorgangs.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
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 Datenstrom, der Den Inhalt darstellt, gelesen wurde (es sei denn, CreateContentReadStream(CancellationToken) wurde implementiert, um andernfalls zu tun).
Wenn Sie z. B. HttpClientverwenden, gibt eine Methode wie SendAsync eine von HttpContent abgeleitete Klasse zurück, die bedingt puffert, basierend auf dem, was für den completionOption-Parameter übergeben wird.
Nach Abschluss des Vorgangs enthält die Result-Eigenschaft des zurückgegebenen Aufgabenobjekts den Datenstrom, der den HTTP-Inhalt darstellt. Der zurückgegebene Datenstrom kann dann zum Lesen des Inhalts mithilfe verschiedener Stream-APIs verwendet werden.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungs exceptions, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von ReadAsStream()ausgelösten Ausnahmen.
