HttpRequest::InsertEntityBody Method (array<Byte>, Int32, Int32)
Provides IIS with a copy of the HTTP request entity body and with information about the request entity object.
Assembly: System.Web (in System.Web.dll)
[AspNetHostingPermissionAttribute(SecurityAction::Demand, Level = AspNetHostingPermissionLevel::High)] public: void InsertEntityBody( array<unsigned char>^ buffer, int offset, int count )
Parameters
- buffer
- Type: array<System::Byte>
An array that contains the request entity data.
- offset
- Type: System::Int32
The zero-based position in buffer at which to begin storing the request entity data.
- count
- Type: System::Int32
The number of bytes to read into the buffer array.
| Exception | Condition |
|---|---|
| PlatformNotSupportedException | The method was invoked on a version of IIS earlier than IIS 7.0. |
| ArgumentNullException | buffer is nullptr. |
| ArgumentOutOfRangeException | count is a negative value. |
| ArgumentOutOfRangeException | offset is a negative value. |
| ArgumentException | The number of items in count is larger than the available space in buffer, given the offset value. |
IIS does not maintain a copy of the request after it has been read. Therefore, it is recommended that only the handler for an HTTP request should read the request entity.
The HttpRequest::InsertEntityBody method overload is useful when you want to perform custom processing, such as inserting a different entity body into memory.
- AspNetHostingPermission
for operating in a hosted environment. Security action: Demand. Associated enumeration: High
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.