HttpRequest.InsertEntityBody Metod

Definition

Namnområde:
System.Web
Sammansättning:
System.Web.dll

Tillhandahåller en hanterad omslutning för IIS-metoden som infogar en HTTP-begärandeentitetstext i minnet.

Överlagringar

Name Description
InsertEntityBody()

Tillhandahåller IIS med en kopia av HTTP-begärandeentitetens brödtext.
InsertEntityBody(Byte[], Int32, Int32)

Tillhandahåller IIS med en kopia av HTTP-begärandeentitetens brödtext och med information om entitetsobjektet för begäran.

Kommentarer

Metoden InsertEntityBody överbelastar ger hanterad åtkomst till IIS 7-metoden IHttpRequest::InsertEntityBody . IIS-metoden infogar en HTTP-begärandeentitetstext (de data som publiceras av en klient) i minnet. Detta är användbart eftersom IIS inte underhåller en kopia av begärandeentiteten när den har lästs. Metoderna InsertEntityBody skapar en kopia av HTTP-begärandeentitetsdata och gör den tillgänglig för IIS för ytterligare anpassad hantering.

Note

Metoden InsertEntityBody överlagrar fungerar bara på IIS 7.0 eller senare, eftersom IHttpRequest::InsertEntityBody metoden lades till i IIS 7.0.

InsertEntityBody()

Tillhandahåller IIS med en kopia av HTTP-begärandeentitetens brödtext.

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

Undantag

PlatformNotSupportedException

Metoden anropades på en tidigare version av IIS än IIS 7.0.

Kommentarer

IIS underhåller inte en kopia av begäran när den har lästs. Därför rekommenderar vi att endast hanteraren för en HTTP-begäran läser begärandeentiteten.

Metoden HttpRequest.InsertEntityBody ger IIS en kopia av begärandeentiteten om den tidigare lästes av ASP.NET. Den här metoden är användbar för fall där ASP.NET har läst entitetsbegäran och du vill återanvända befintliga begärandedata.

Gäller för

InsertEntityBody(Byte[], Int32, Int32)

Tillhandahåller IIS med en kopia av HTTP-begärandeentitetens brödtext och med information om entitetsobjektet för begäran.

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)

Parametrar

buffer
Byte[]

En matris som innehåller entitetsdata för begäran.

offset
Int32

Den nollbaserade position buffer där du kan börja lagra entitetsdata för begäran.

count
Int32

Antalet byte som ska läsas in i matrisen buffer .

Undantag

PlatformNotSupportedException

Metoden anropades på en tidigare version av IIS än IIS 7.0.

ArgumentNullException

buffer är null.

ArgumentOutOfRangeException

offset eller count är ett negativt värde.

ArgumentException

Antalet objekt i count är större än det tillgängliga utrymmet i buffer, givet offset värdet.

Kommentarer

IIS underhåller inte en kopia av begäran när den har lästs. Därför rekommenderar vi att endast hanteraren för en HTTP-begäran läser begärandeentiteten.

Metodens HttpRequest.InsertEntityBody överlagring är användbar när du vill utföra anpassad bearbetning, till exempel genom att infoga en annan entitetstext i minnet.

Gäller för