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

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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)

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.

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.

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

.NET Framework
Available since 4.0
Return to top
Show: