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 для дополнительной пользовательской обработки.

Примечание

Перегрузки 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 метода полезна, если требуется выполнить пользовательскую обработку, например вставку другого тела сущности в память.

Применяется к