HttpRequest::InsertEntityBody Method (array<Byte>^, Int32, Int32)

.NET Framework (current version)

Provides IIS with a copy of the HTTP request entity body and with information about the request entity object.

Namespace: System.Web
Assembly: System.Web (in System.Web.dll)

Syntax

public:
[AspNetHostingPermissionAttribute(SecurityAction::Demand, Level = AspNetHostingPermissionLevel::High)]
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.

Exceptions

Exception	Condition
PlatformNotSupportedException	The method was invoked on a version of IIS earlier than IIS 7.0.
ArgumentNullException	buffer is null.
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.

Remarks

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.

Security

AspNetHostingPermission

for operating in a hosted environment. Security action: Demand. Associated enumeration: High

Version Information

.NET Framework
Available since 4.0