HttpContent.CreateContentReadStream(CancellationToken) Methode

Definition

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Quelle:

HttpContent.cs

Serialisiert den HTTP-Inhalt in einen Speicherdatenstrom.

protected:
 virtual System::IO::Stream ^ CreateContentReadStream(System::Threading::CancellationToken cancellationToken);

protected virtual System.IO.Stream CreateContentReadStream (System.Threading.CancellationToken cancellationToken);

abstract member CreateContentReadStream : System.Threading.CancellationToken -> System.IO.Stream
override this.CreateContentReadStream : System.Threading.CancellationToken -> System.IO.Stream

Protected Overridable Function CreateContentReadStream (cancellationToken As CancellationToken) As Stream

Parameter

cancellationToken

CancellationToken

Das Abbruchtoken, um den Vorgang abzubrechen.

Gibt zurück

Stream

Der Ausgabespeicherdatenstrom, der den serialisierten HTTP-Inhalt enthält.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Nach Abschluss des Vorgangs stellt der zurückgegebene Speicherdatenstrom den HTTP-Inhalt dar. Der zurückgegebene Stream kann dann verwendet werden, um den Inhalt mithilfe verschiedener Stream-APIs zu lesen. Die CreateContentReadStream(CancellationToken) -Methode puffert den Inhalt in einen Speicherdatenstrom. Abgeleitete Klassen können dieses Verhalten außer Kraft setzen, wenn es eine bessere Möglichkeit gibt, den Inhalt als Stream abzurufen. Beispielsweise könnte ein Bytearray oder eine Zeichenfolge eine effizientere Methode verwenden, z. B. das Umschließen eines schreibgeschützten MemoryStream um die Bytes oder die Zeichenfolge.