HttpRequest.InsertEntityBody Yöntem

Tanım

Ad Alanı:

System.Web

Bütünleştirilmiş Kod:

System.Web.dll

BELLeğe HTTP isteği varlık gövdesini ekleyen IIS yöntemi için yönetilen sarmalayıcı sağlar.

Aşırı Yüklemeler

InsertEntityBody()	IIS'ye HTTP isteği varlık gövdesinin bir kopyasını sağlar.
InsertEntityBody(Byte[], Int32, Int32)	IIS'ye HTTP isteği varlık gövdesinin bir kopyasını ve istek varlığı nesnesi hakkındaki bilgileri sağlar.

Açıklamalar

Yöntem InsertEntityBody aşırı yüklemeleri, IIS 7 IHttpRequest::InsertEntityBody yöntemine yönetilen erişim sağlar. IIS yöntemi belleğe bir HTTP isteği varlık gövdesi (istemci tarafından gönderilen veriler) ekler. Iis, okunduktan sonra istek varlığının bir kopyasını tutmadığından bu yararlı olur. Yöntemler HTTP InsertEntityBody isteği varlık verilerinin bir kopyasını oluşturur ve ek özel işleme için IIS'nin kullanımına açar.

Not

InsertEntityBody Yöntem, IIS 7.0'a eklendiğindenIHttpRequest::InsertEntityBody, yöntem aşırı yüklemeleri yalnızca IIS 7.0 veya sonraki sürümlerde çalışır.

InsertEntityBody()

IIS'ye HTTP isteği varlık gövdesinin bir kopyasını sağlar.

public:
 void InsertEntityBody();

public void InsertEntityBody ();

member this.InsertEntityBody : unit -> unit

Public Sub InsertEntityBody ()

Özel durumlar

PlatformNotSupportedException

yöntemi IIS 7.0'dan önceki bir IIS sürümünde çağrıldı.

Açıklamalar

IIS, okunduktan sonra isteğin bir kopyasını tutmaz. Bu nedenle, yalnızca http isteği işleyicisinin istek varlığını okuması önerilir.

Yöntem HttpRequest.InsertEntityBody aşırı yüklemesi, daha önce ASP.NET tarafından okunmuşsa IIS'ye istek varlığının bir kopyasını sağlar. Bu yöntem aşırı yüklemesi, ASP.NET varlık isteğini okuduğu ve var olan istek verilerini yeniden kullanmak istediğiniz durumlar için kullanışlıdır.

InsertEntityBody(Byte[], Int32, Int32)

IIS'ye HTTP isteği varlık gövdesinin bir kopyasını ve istek varlığı nesnesi hakkındaki bilgileri sağlar.

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)

Parametreler

buffer

Byte[]

İstek varlığı verilerini içeren bir dizi.

offset

Int32

İstek varlık verilerinin depolandığı sıfır tabanlı konum buffer .

count

Int32

Diziye buffer okunacak bayt sayısı.

Özel durumlar

PlatformNotSupportedException

yöntemi IIS 7.0'dan önceki bir IIS sürümünde çağrıldı.

ArgumentNullException

buffer, null değeridir.

ArgumentOutOfRangeException

offset veya count negatif bir değerdir.

ArgumentException

içindeki count öğelerin sayısı, değeri verildiğinde içindeki bufferkullanılabilir alandan offset daha büyük.

Açıklamalar

IIS, okunduktan sonra isteğin bir kopyasını tutmaz. Bu nedenle, yalnızca http isteği işleyicisinin istek varlığını okuması önerilir.

Yöntem HttpRequest.InsertEntityBody aşırı yüklemesi, belleğe farklı bir varlık gövdesi ekleme gibi özel işleme gerçekleştirmek istediğinizde kullanışlıdır.