HttpRequest.InsertEntityBody Metode

Definisi

Ruang nama:

System.Web

Rakitan:

System.Web.dll

Menyediakan pembungkus terkelola untuk metode IIS yang menyisipkan isi entitas permintaan HTTP ke dalam memori.

Overload

Nama	Deskripsi
InsertEntityBody()	Menyediakan IIS dengan salinan isi entitas permintaan HTTP.
InsertEntityBody(Byte[], Int32, Int32)	Menyediakan IIS dengan salinan isi entitas permintaan HTTP dan dengan informasi tentang objek entitas permintaan.

Keterangan

Metode InsertEntityBody kelebihan beban menyediakan akses terkelola ke metode IIS 7 IHttpRequest::InsertEntityBody . Metode IIS menyisipkan isi entitas permintaan HTTP (data yang diposting oleh klien) ke dalam memori. Ini berguna karena IIS tidak mempertahankan salinan entitas permintaan setelah dibaca. Metode InsertEntityBody membuat salinan data entitas permintaan HTTP dan membuatnya tersedia untuk IIS untuk penanganan kustom tambahan.

Note

Metode InsertEntityBody kelebihan beban hanya berfungsi pada IIS 7.0 atau yang IHttpRequest::InsertEntityBody lebih baru, karena metode ditambahkan di IIS 7.0.

InsertEntityBody()

Menyediakan IIS dengan salinan isi entitas permintaan HTTP.

public:
 void InsertEntityBody();

public void InsertEntityBody();

member this.InsertEntityBody : unit -> unit

Public Sub InsertEntityBody ()

Pengecualian

PlatformNotSupportedException

Metode ini dipanggil pada versi IIS yang lebih lama dari IIS 7.0.

Keterangan

IIS tidak mempertahankan salinan permintaan setelah dibaca. Oleh karena itu, disarankan agar hanya handler untuk permintaan HTTP yang harus membaca entitas permintaan.

Kelebihan metode HttpRequest.InsertEntityBody menyediakan IIS dengan salinan entitas permintaan jika sebelumnya dibaca oleh ASP.NET. Kelebihan beban metode ini berguna untuk kasus di mana ASP.NET telah membaca permintaan entitas dan Anda ingin menggunakan kembali data permintaan yang ada.

InsertEntityBody(Byte[], Int32, Int32)

Menyediakan IIS dengan salinan isi entitas permintaan HTTP dan dengan informasi tentang objek entitas permintaan.

public:
 void InsertEntityBody(cli::array <System::Byte> ^ buffer, int offset, int count);

public void InsertEntityBody(byte[] buffer, int offset, int count);

member this.InsertEntityBody : byte[] * int * int -> unit

Public Sub InsertEntityBody (buffer As Byte(), offset As Integer, count As Integer)

Parameter

buffer

Byte[]

Array yang berisi data entitas permintaan.

offset

Int32

Posisi berbasis nol di buffer mana untuk mulai menyimpan data entitas permintaan.

count

Int32

Jumlah byte yang akan dibaca ke buffer dalam array.

Pengecualian

PlatformNotSupportedException

Metode ini dipanggil pada versi IIS yang lebih lama dari IIS 7.0.

ArgumentNullException

buffer adalah null.

ArgumentOutOfRangeException

offset atau count adalah nilai negatif.

ArgumentException

Jumlah item di count lebih besar dari ruang yang tersedia di buffer, mengingat nilainya offset .

Keterangan

IIS tidak mempertahankan salinan permintaan setelah dibaca. Oleh karena itu, disarankan agar hanya handler untuk permintaan HTTP yang harus membaca entitas permintaan.

Kelebihan HttpRequest.InsertEntityBody beban metode berguna ketika Anda ingin melakukan pemrosesan kustom, seperti memasukkan isi entitas yang berbeda ke dalam memori.