Udostępnij za pośrednictwem


HttpRequest.InsertEntityBody Metoda

Definicja

Udostępnia zarządzaną otokę dla metody iis, która wstawia treść jednostki żądania HTTP do pamięci.

Przeciążenia

InsertEntityBody()

Dostarcza usługom IIS kopię treści jednostki żądania HTTP.

InsertEntityBody(Byte[], Int32, Int32)

Dostarcza usługom IIS kopię treści jednostki żądania HTTP oraz informacje o obiekcie jednostki żądania.

Uwagi

Przeciążenia InsertEntityBody metody zapewniają zarządzany dostęp do metody usług IIS 7 IHttpRequest::InsertEntityBody . Metoda IIS wstawia treść jednostki żądania HTTP (dane publikowane przez klienta) do pamięci. Jest to przydatne, ponieważ usługi IIS nie utrzymują kopii jednostki żądania po jej odczytaniu. Metody InsertEntityBody tworzą kopię danych jednostki żądania HTTP i udostępniają je usługom IIS w celu dodatkowej obsługi niestandardowej.

Uwaga

Przeciążenia InsertEntityBody metody działają tylko w usługach IIS 7.0 lub nowszych, ponieważ IHttpRequest::InsertEntityBody metoda została dodana w usługach IIS 7.0.

InsertEntityBody()

Dostarcza usługom IIS kopię treści jednostki żądania HTTP.

public:
 void InsertEntityBody();
public void InsertEntityBody ();
member this.InsertEntityBody : unit -> unit
Public Sub InsertEntityBody ()

Wyjątki

Metoda została wywołana w wersji usług IIS wcześniejszej niż IIS 7.0.

Uwagi

Usługi IIS nie utrzymują kopii żądania po jego odczytaniu. W związku z tym zaleca się, aby tylko program obsługi żądania HTTP powinien odczytać jednostkę żądania.

Przeciążenie HttpRequest.InsertEntityBody metody zapewnia usługom IIS kopię jednostki żądania, jeśli została wcześniej odczytana przez ASP.NET. To przeciążenie metody jest przydatne w przypadkach, gdy ASP.NET odczytał żądanie jednostki i chcesz ponownie użyć istniejących danych żądania.

Dotyczy

InsertEntityBody(Byte[], Int32, Int32)

Dostarcza usługom IIS kopię treści jednostki żądania HTTP oraz informacje o obiekcie jednostki żądania.

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)

Parametry

buffer
Byte[]

Tablica zawierająca dane jednostki żądania.

offset
Int32

Położenie na podstawie zera, w buffer którym należy rozpocząć przechowywanie danych jednostki żądania.

count
Int32

Liczba bajtów do odczytania w tablicy buffer .

Wyjątki

Metoda została wywołana w wersji usług IIS wcześniejszej niż IIS 7.0.

buffer to null.

offset lub count jest wartością ujemną.

Liczba elementów w count elemecie jest większa niż dostępna przestrzeń w bufferelemecie , biorąc pod offset uwagę wartość .

Uwagi

Usługi IIS nie utrzymują kopii żądania po jego odczytaniu. W związku z tym zaleca się, aby tylko program obsługi żądania HTTP powinien odczytać jednostkę żądania.

Przeciążenie HttpRequest.InsertEntityBody metody jest przydatne, gdy chcesz wykonać przetwarzanie niestandardowe, takie jak wstawianie innej treści jednostki do pamięci.

Dotyczy