HttpRequest.GetBufferlessInputStream Yöntem

Tanım

Ad Alanı:

System.Web

Bütünleştirilmiş Kod:

System.Web.dll

Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir Stream nesne alır.

Aşırı Yüklemeler

GetBufferlessInputStream()	Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir Stream nesne alır.
GetBufferlessInputStream(Boolean)	Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir Stream nesne alır ve isteğe bağlı olarak özelliğinde MaxRequestLength ayarlanan istek uzunluğu sınırını devre dışı bırakır.

GetBufferlessInputStream()

Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir Stream nesne alır.

public:
 System::IO::Stream ^ GetBufferlessInputStream();

public System.IO.Stream GetBufferlessInputStream ();

member this.GetBufferlessInputStream : unit -> System.IO.Stream

Public Function GetBufferlessInputStream () As Stream

Döndürülenler

Stream

Stream Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir nesne.

Özel durumlar

HttpException

İsteğin varlık gövdesi zaten yüklenmiş ve ayrıştırılmış. Varlık gövdesinin yüklenmesine ve ayrıştırılmasına neden olan özelliklere örnek olarak şunlar verilebilir:

• Form

• InputStream

• Files

• GetBufferedInputStream()

Bu özel durumu önlemek için önce yöntemini çağırın ReadEntityBodyMode . Varlık gövdesi okunurken istemcinin bağlantısının kesilmesi durumunda da bu özel durum oluşur.

Açıklamalar

Bu yöntem, özelliğini kullanmaya InputStream bir alternatif sağlar. özelliği, InputStream bir nesne döndürmeden Stream önce isteğin tamamı alınana kadar bekler. Buna karşılık yöntemi nesneyi GetBufferlessInputStream hemen döndürür Stream . Gövdenin tüm içeriği alınmadan önce varlık gövdesini işlemeye başlamak için yöntemini kullanabilirsiniz.

Varlık gövdesi (veya istediğiniz kadar ve alındı) yalnızca bu yöntem tarafından döndürülen nesneyi kullanarak akışı okumak için yöntemi gibi Read yöntemleri çağırarak döndürülür. Varlık gövdesinin ne kadarının Read okunacağını belirtmek için yönteminin parametrelerini kullanırsınız.

Stream Bu yöntemden ASP.NET tarafından döndürülen nesne hem zaman uyumlu hem de zaman uyumsuz okuma yöntemlerini destekler. Stream nesnesi hem ve BeginRead EndRead yöntemlerini uygular. Zaman uyumsuz yöntemler, istek varlığını öbekler halinde zaman uyumsuz olarak okumanıza olanak sağlarken, ASP.NET zaman uyumsuz bir okuma döngüsünün her yinelemesi arasında geçerli iş parçacığını serbest bırakır.

İstek büyük bir dosyayı karşıya yüklüyorsa ve karşıya yükleme tamamlanmadan önce dosya içeriğine erişmeye başlamak istiyorsanız bu yöntem yararlı olabilir. Ancak, bu yöntemi yalnızca varlık gövdesinin tüm işlemlerini devralmak istediğiniz senaryolar için kullanmanız gerekir. Bu, bir .aspx sayfası çalıştırıldığında varlık gövdesinin zaten okunmuş olması nedeniyle bir .aspx sayfasından bu yöntemi kullanamayacağınız anlamına gelir.

Ayrıca bkz.

• GetBufferedInputStream()

GetBufferlessInputStream(Boolean)

Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir Stream nesne alır ve isteğe bağlı olarak özelliğinde MaxRequestLength ayarlanan istek uzunluğu sınırını devre dışı bırakır.

public:
 System::IO::Stream ^ GetBufferlessInputStream(bool disableMaxRequestLength);

public System.IO.Stream GetBufferlessInputStream (bool disableMaxRequestLength);

member this.GetBufferlessInputStream : bool -> System.IO.Stream

Public Function GetBufferlessInputStream (disableMaxRequestLength As Boolean) As Stream

Parametreler

disableMaxRequestLength

Boolean

true istek uzunluğu sınırını devre dışı bırakmak için; aksi takdirde , false.

Döndürülenler

Stream

Stream Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir nesne.

Özel durumlar

HttpException

İsteğin varlık gövdesi zaten yüklenmiş ve ayrıştırılmış. Varlık gövdesinin yüklenmesine ve ayrıştırılmasına neden olan özelliklere örnek olarak şunlar verilebilir:

• Özelliği Form .

• Özelliği Files .

• Özelliği InputStream .

GetBufferedInputStream()- Yöntemi.

Bu özel durumu önlemek için önce yöntemini çağırın ReadEntityBodyMode . Varlık gövdesi okunurken istemcinin bağlantısının kesilmesi durumunda da bu özel durum oluşur.

Açıklamalar

Bu yöntem hakkında daha fazla bilgi için bkz GetBufferlessInputStream() . aşırı yükleme.

Ayrıca bkz.

• GetBufferedInputStream()