HttpRequest.InsertEntityBody Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

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

PlatformNotSupportedException

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.

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

PlatformNotSupportedException

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

ArgumentNullException

buffer to null.

ArgumentOutOfRangeException

offset lub count jest wartością ujemną.

ArgumentException

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.