HttpRequest.InsertEntityBody Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет управляемую оболочку для метода 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 -> unitPublic Sub InsertEntityBody ()Исключения
Метод был вызван для версии 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 -> unitPublic Sub InsertEntityBody (buffer As Byte(), offset As Integer, count As Integer)Параметры
- buffer
- Byte[]
Массив, который содержит данные запроса.
- offset
- Int32
Отсчитываемая от нуля позиция в параметре buffer, с которой начинается хранение данных объекта запроса.
- count
- Int32
Число байтов, считываемых в массив buffer.
Исключения
Метод был вызван для версии IIS более ранней, чем IIS 7.0.
buffer имеет значение null.
offset или count является отрицательным значением.
Число элементов в count превышает доступное пространство в buffer при заданном значении offset.
Комментарии
Службы IIS не поддерживают копию запроса после его чтения. Поэтому рекомендуется, чтобы только обработчик HTTP-запроса считывал сущность запроса.
Перегрузка HttpRequest.InsertEntityBody метода полезна, если требуется выполнить пользовательскую обработку, например вставку другого тела сущности в память.
