HttpRequest.InsertEntityBody Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Poskytuje spravovaný obálku pro metodu SLUŽBY IIS, která vloží tělo entity požadavku HTTP do paměti.

Přetížení

InsertEntityBody()	Poskytuje službu IIS s kopií těla entity požadavku HTTP.
InsertEntityBody(Byte[], Int32, Int32)	Poskytuje iis kopii textu entity požadavku HTTP a informace o objektu entity požadavku.

Poznámky

Přetížení InsertEntityBody metody poskytují spravovaný přístup k metodě IIS 7 IHttpRequest::InsertEntityBody . Metoda SLUŽBY IIS vloží do paměti text entity požadavku HTTP (data, která klient publikuje). To je užitečné, protože služba IIS po přečtení neudržuje kopii entity požadavku. Metody InsertEntityBody vytvoří kopii dat entity požadavku HTTP a zpřístupní je službě IIS pro další vlastní zpracování.

Poznámka

Přetížení InsertEntityBody metody funguje pouze ve službě IIS 7.0 nebo novější, protože IHttpRequest::InsertEntityBody metoda byla přidána ve službě IIS 7.0.

InsertEntityBody()

Poskytuje službu IIS s kopií těla entity požadavku HTTP.

public:
 void InsertEntityBody();

public void InsertEntityBody ();

member this.InsertEntityBody : unit -> unit

Public Sub InsertEntityBody ()

Výjimky

PlatformNotSupportedException

Metoda byla vyvolána ve verzi služby IIS starší než IIS 7.0.

Poznámky

Služba IIS po přečtení neudržuje kopii požadavku. Proto se doporučuje, aby entitu požadavku http přečetla jenom obslužná rutina požadavku.

Přetížení HttpRequest.InsertEntityBody metody poskytuje IIS kopii entity požadavku, pokud byla dříve přečtená ASP.NET. Toto přetížení metody je užitečné v případech, kdy ASP.NET přečetl požadavek entity a chcete znovu použít existující data požadavku.

InsertEntityBody(Byte[], Int32, Int32)

Poskytuje iis kopii textu entity požadavku HTTP a informace o objektu entity požadavku.

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[]

Pole, které obsahuje data entity požadavku.

offset

Int32

Pozice založená na nule, ve buffer které se mají začít ukládat data entity požadavku.

count

Int32

Počet bajtů, které se mají přečíst do buffer pole.

Výjimky

PlatformNotSupportedException

Metoda byla vyvolána ve verzi služby IIS starší než IIS 7.0.

ArgumentNullException

buffer je null.

ArgumentOutOfRangeException

offset nebo count je záporná hodnota.

ArgumentException

Počet položek, ve count které je větší než dostupné místo v bufferhodnotě offset .

Poznámky

Služba IIS po přečtení neudržuje kopii požadavku. Proto se doporučuje, aby entitu požadavku požadavku HTTP přečetla pouze obslužná rutina požadavku.

Přetížení HttpRequest.InsertEntityBody metody je užitečné, když chcete provést vlastní zpracování, například vložení jiného těla entity do paměti.