HttpContent.ReadAsStreamAsync Metode

Definisi

Ruang nama:

System.Net.Http

Rakitan:

System.Net.Http.dll

Menserialisasikan konten HTTP dan mengembalikan aliran yang mewakili konten.

Overload

ReadAsStreamAsync()	Serialisasi konten HTTP dan kembalikan aliran yang mewakili konten sebagai operasi asinkron.
ReadAsStreamAsync(CancellationToken)	Serialisasi konten HTTP dan kembalikan aliran yang mewakili konten sebagai operasi asinkron.

Keterangan

Perhatikan bahwa metode ini akan secara internal menyangga konten kecuali CreateContentReadStreamAsync() telah diimplementasikan untuk melakukan sebaliknya.

ReadAsStreamAsync()

Sumber:

HttpContent.cs

Serialisasi konten HTTP dan kembalikan aliran yang mewakili konten sebagai operasi asinkron.

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)

Mengembalikan

Task<Stream>

Objek tugas yang mewakili operasi asinkron.

Keterangan

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah semua aliran yang mewakili konten telah dibaca.

Setelah operasi selesai, properti Result pada objek tugas yang dikembalikan berisi aliran yang mewakili konten HTTP. Aliran yang dikembalikan kemudian dapat digunakan untuk membaca konten menggunakan berbagai API streaming.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh ReadAsStream().

ReadAsStreamAsync(CancellationToken)

Sumber:

HttpContent.cs

Serialisasi konten HTTP dan kembalikan aliran yang mewakili konten sebagai operasi asinkron.

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

Token pembatalan untuk membatalkan operasi.

Mengembalikan

Task<Stream>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah semua aliran yang mewakili konten telah dibaca (kecuali CreateContentReadStream(CancellationToken) telah diimplementasikan untuk melakukan sebaliknya). Misalnya, saat menggunakan HttpClient, metode seperti SendAsync mengembalikan kelas yang berasal dari HttpContent buffer kondisional berdasarkan apa yang diteruskan untuk parameter completionOption.

Setelah operasi selesai, properti Result pada objek tugas yang dikembalikan berisi aliran yang mewakili konten HTTP. Aliran yang dikembalikan kemudian dapat digunakan untuk membaca konten menggunakan berbagai API streaming.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh ReadAsStream().