HttpRequest.InsertEntityBody Metódus

Definíció

Névtér:

System.Web

Szerelvény:

System.Web.dll

Felügyelt burkolót biztosít az IIS-metódushoz, amely egy HTTP-kérelem entitástörzsét szúrja be a memóriába.

Túlterhelések

Name	Description
InsertEntityBody()	Az IIS-nek a HTTP-kérelem entitás törzsének egy példányát biztosítja.
InsertEntityBody(Byte[], Int32, Int32)	Az IIS-nek a HTTP-kérelem entitás törzsének másolatát és a kérelem entitásobjektumára vonatkozó információkat biztosít.

Megjegyzések

A InsertEntityBody metódus túlterhelései felügyelt hozzáférést biztosítanak az IIS 7 IHttpRequest::InsertEntityBody metódushoz. Az IIS-metódus egy HTTP-kérelem entitástörzsét (az ügyfél által közzétett adatokat) szúrja be a memóriába. Ez azért hasznos, mert az IIS nem tartja fenn a kérelem entitás másolatát az olvasás után. A InsertEntityBody metódusok létrehoznak egy másolatot a HTTP-kérelem entitásadatairól, és elérhetővé teszik azokat az IIS számára további egyéni kezelés céljából.

Note

A InsertEntityBody metódus túlterhelése csak az IIS 7.0-s vagy újabb verzióján működik, mivel a metódus az IHttpRequest::InsertEntityBody IIS 7.0-s verziójában lett hozzáadva.

InsertEntityBody()

Az IIS-nek a HTTP-kérelem entitás törzsének egy példányát biztosítja.

public:
 void InsertEntityBody();

public void InsertEntityBody();

member this.InsertEntityBody : unit -> unit

Public Sub InsertEntityBody ()

Kivételek

PlatformNotSupportedException

A metódust az IIS 7.0-nál korábbi verziójában hívták meg.

Megjegyzések

Az IIS az olvasás után nem tartja fenn a kérés másolatát. Ezért javasoljuk, hogy csak a HTTP-kérés kezelője olvassa el a kérelem entitását.

A HttpRequest.InsertEntityBody metódus túlterhelése biztosítja az IIS számára a kérelem entitás másolatát, ha azt korábban ASP.NET olvasta. Ez a metódus túlterhelés olyan esetekben hasznos, amikor ASP.NET elolvasta az entitáskérelmet, és a meglévő kérelemadatokat szeretné újra felhasználni.

InsertEntityBody(Byte[], Int32, Int32)

Az IIS-nek a HTTP-kérelem entitás törzsének másolatát és a kérelem entitásobjektumára vonatkozó információkat biztosít.

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)

Paraméterek

buffer

Byte[]

A kérelem entitásadatait tartalmazó tömb.

offset

Int32

Az a nulla alapú pozíció buffer , amelyben a kérelem entitásadatainak tárolását meg kell kezdeni.

count

Int32

A tömbbe buffer beolvasandó bájtok száma.

Kivételek

PlatformNotSupportedException

A metódust az IIS 7.0-nál korábbi verziójában hívták meg.

ArgumentNullException

buffer az null.

ArgumentOutOfRangeException

offset vagy count negatív érték.

ArgumentException

A benne lévő count elemek száma az érték alapján nagyobb, mint a buffer szabad területoffset.

Megjegyzések

Az IIS az olvasás után nem tartja fenn a kérés másolatát. Ezért javasoljuk, hogy csak a HTTP-kérés kezelője olvassa el a kérelem entitását.

A HttpRequest.InsertEntityBody metódus túlterhelése akkor hasznos, ha egyéni feldolgozást szeretne végezni, például egy másik entitástörzset szúr be a memóriába.