HttpRequest.InsertEntityBody Method (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)

<AspNetHostingPermissionAttribute(SecurityAction.Demand, Level := AspNetHostingPermissionLevel.High)>
Public Sub InsertEntityBody (
	buffer As Byte(),
	offset As Integer,
	count As Integer
)

Parameters

buffer
Type: 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: