HttpContent.ReadAsStreamAsync Methode

Definition

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

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

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

Task<Stream>

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.

ReadAsStreamAsync(CancellationToken)

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

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

OperationCanceledException

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.