HttpRequest.InsertEntityBody Метод

Определение

Пространство имен:

System.Web

Сборка:

System.Web.dll

Предоставляет управляемую оболочку для метода IIS, который вставляет текст сущности HTTP-запроса в память.

Перегрузки

Имя	Описание
InsertEntityBody()	Предоставляет iis копию текста сущности HTTP-запроса.
InsertEntityBody(Byte[], Int32, Int32)	Предоставляет iis копию текста сущности HTTP-запроса и сведения об объекте сущности запроса.

Комментарии

Перегрузки InsertEntityBody методов предоставляют управляемый доступ к методу IIS 7 IHttpRequest::InsertEntityBody . Метод IIS вставляет текст сущности HTTP-запроса (данные, размещенные клиентом) в память. Это полезно, так как службы IIS не поддерживают копию сущности запроса после его чтения. Методы InsertEntityBody создают копию данных сущности HTTP-запроса и предоставляют доступ к службам IIS для дополнительной пользовательской обработки.

Note

Перегрузки InsertEntityBody методов работают только в IIS 7.0 или более поздней версии, так как IHttpRequest::InsertEntityBody метод был добавлен в IIS 7.0.

InsertEntityBody()

Предоставляет iis копию текста сущности HTTP-запроса.

public:
 void InsertEntityBody();

public void InsertEntityBody();

member this.InsertEntityBody : unit -> unit

Public Sub InsertEntityBody ()

Исключения

PlatformNotSupportedException

Метод был вызван в версии IIS ранее, чем IIS 7.0.

Комментарии

СЛУЖБЫ IIS не поддерживают копию запроса после его чтения. Поэтому рекомендуется считать сущность запроса только обработчиком HTTP-запроса.

Перегрузка метода HttpRequest.InsertEntityBody предоставляет службам IIS копию сущности запроса, если она была прочитана ранее ASP.NET. Эта перегрузка метода полезна в случаях, когда ASP.NET считывает запрос сущности, и вы хотите повторно использовать существующие данные запроса.

InsertEntityBody(Byte[], Int32, Int32)

Предоставляет iis копию текста сущности HTTP-запроса и сведения об объекте сущности запроса.

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)

Параметры

buffer

Byte[]

Массив, содержащий данные сущности запроса.

offset

Int32

Отсчитываемая от нуля позиция, с buffer которой начинается хранение данных сущности запроса.

count

Int32

Число байтов для чтения в buffer массив.

Исключения

PlatformNotSupportedException

Метод был вызван в версии IIS ранее, чем IIS 7.0.

ArgumentNullException

buffer равно null.

ArgumentOutOfRangeException

offset или count отрицательное значение.

ArgumentException

Число элементов в count больше, чем доступное пространство в buffer, учитывая offset значение.

Комментарии

СЛУЖБЫ IIS не поддерживают копию запроса после его чтения. Поэтому рекомендуется считать сущность запроса только обработчиком HTTP-запроса.

Перегрузка HttpRequest.InsertEntityBody метода полезна при выполнении пользовательской обработки, например вставке другого тела сущности в память.