HttpRequest.GetBufferlessInputStream Metode

Definisi

Ruang nama:

System.Web

Rakitan:

System.Web.dll

Stream Mendapatkan objek yang dapat digunakan untuk membaca isi entitas HTTP yang masuk.

Overload

GetBufferlessInputStream()	Stream Mendapatkan objek yang dapat digunakan untuk membaca isi entitas HTTP yang masuk.
GetBufferlessInputStream(Boolean)	Stream Mendapatkan objek yang dapat digunakan untuk membaca isi entitas HTTP masuk, secara opsional menonaktifkan batas panjang permintaan yang diatur dalam MaxRequestLength properti .

GetBufferlessInputStream()

Stream Mendapatkan objek yang dapat digunakan untuk membaca isi entitas HTTP yang masuk.

public:
 System::IO::Stream ^ GetBufferlessInputStream();

public System.IO.Stream GetBufferlessInputStream ();

member this.GetBufferlessInputStream : unit -> System.IO.Stream

Public Function GetBufferlessInputStream () As Stream

Mengembalikan

Stream

Objek Stream yang dapat digunakan untuk membaca isi entitas HTTP yang masuk.

Pengecualian

HttpException

Badan entitas permintaan telah dimuat dan diurai. Contoh properti yang menyebabkan badan entitas dimuat dan diurai meliputi yang berikut ini:

• Form

• InputStream

• Files

• GetBufferedInputStream()

Untuk menghindari pengecualian ini, panggil metode terlebih ReadEntityBodyMode dahulu. Pengecualian ini juga dilemparkan jika klien terputus saat badan entitas sedang dibaca.

Keterangan

Metode ini menyediakan alternatif untuk menggunakan InputStream properti . Properti InputStream menunggu hingga seluruh permintaan diterima sebelum mengembalikan Stream objek. Sebaliknya, GetBufferlessInputStream metode segera mengembalikan Stream objek . Anda dapat menggunakan metode untuk mulai memproses badan entitas sebelum konten lengkap isi telah diterima.

Badan entitas (atau sebanyak yang Anda minta dan telah diterima) dikembalikan hanya ketika Anda menggunakan objek yang dikembalikan oleh metode ini untuk membaca aliran, dengan memanggil metode seperti Read metode . Anda menggunakan parameter Read metode untuk menentukan berapa banyak isi entitas yang akan dibaca.

Objek Stream yang dikembalikan oleh ASP.NET dari metode ini mendukung metode baca sinkron dan asinkron. Objek Stream mengimplementasikan BeginRead metode dan EndRead . Metode asinkron memungkinkan Anda membaca entitas permintaan secara asinkron dalam gugus, sementara ASP.NET merilis utas saat ini di antara setiap perulangan perulangan baca asinkron.

Metode ini dapat berguna jika permintaan mengunggah file besar dan Anda ingin mulai mengakses konten file sebelum unggahan selesai. Namun, Anda hanya boleh menggunakan metode ini untuk skenario di mana Anda ingin mengambil alih semua pemrosesan badan entitas. Ini berarti Anda tidak dapat menggunakan metode ini dari halaman .aspx, karena pada saat halaman .aspx berjalan, badan entitas telah dibaca.

Lihat juga

• GetBufferedInputStream()

GetBufferlessInputStream(Boolean)

Stream Mendapatkan objek yang dapat digunakan untuk membaca isi entitas HTTP masuk, secara opsional menonaktifkan batas panjang permintaan yang diatur dalam MaxRequestLength properti .

public:
 System::IO::Stream ^ GetBufferlessInputStream(bool disableMaxRequestLength);

public System.IO.Stream GetBufferlessInputStream (bool disableMaxRequestLength);

member this.GetBufferlessInputStream : bool -> System.IO.Stream

Public Function GetBufferlessInputStream (disableMaxRequestLength As Boolean) As Stream

Parameter

disableMaxRequestLength

Boolean

true untuk menonaktifkan batas panjang permintaan; jika tidak, false.

Mengembalikan

Stream

Objek Stream yang dapat digunakan untuk membaca isi entitas HTTP yang masuk.

Pengecualian

HttpException

Badan entitas permintaan telah dimuat dan diurai. Contoh properti yang menyebabkan badan entitas dimuat dan diurai meliputi yang berikut ini:

• FormProperti.

• FilesProperti.

• InputStreamProperti.

• Metode GetBufferedInputStream().

Untuk menghindari pengecualian ini, panggil metode terlebih ReadEntityBodyMode dahulu. Pengecualian ini juga dilemparkan jika klien terputus saat badan entitas sedang dibaca.

Keterangan

Untuk informasi selengkapnya tentang metode ini, lihat GetBufferlessInputStream() kelebihan beban.

Lihat juga

• GetBufferedInputStream()