HttpRequest.GetBufferlessInputStream Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir Stream nesne alır.
Aşırı Yüklemeler
| Name | Description |
|---|---|
| GetBufferlessInputStream() |
Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir Stream nesne alır. |
| GetBufferlessInputStream(Boolean) |
İsteğe bağlı olarak özelliğinde ayarlanan MaxRequestLength istek uzunluğu sınırını devre dışı bırakarak gelen HTTP varlık gövdesini okumak için kullanılabilecek bir Stream nesne alı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 Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir nesne.
Özel durumlar
İ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:
Bu özel durumu önlemek için önce yöntemini çağırın ReadEntityBodyMode . Varlık gövdesi okunurken istemcinin bağlantısı kesilirse de bu özel durum oluşturulur.
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, GetBufferlessInputStream yöntemi nesneyi 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 yöntemi gibi Read yöntemler çağrılarak akışı okumak için bu yöntem tarafından döndürülen nesneyi kullandığınızda 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 BeginReadEndRead 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övdesi zaten okunduğu için bu yöntemi bir .aspx sayfasından kullanamayacağınız anlamına gelir.
Ayrıca bkz.
Şunlara uygulanır
GetBufferlessInputStream(Boolean)
İsteğe bağlı olarak özelliğinde ayarlanan MaxRequestLength istek uzunluğu sınırını devre dışı bırakarak gelen HTTP varlık gövdesini okumak için kullanılabilecek bir Stream nesne alı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 Gelen HTTP varlık gövdesini okumak için kullanılabilecek bir nesne.
Özel durumlar
İ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 özelliği.
Files özelliği.
InputStream özelliği.
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ı kesilirse de bu özel durum oluşturulur.
Açıklamalar
Bu yöntem hakkında daha fazla bilgi için bkz GetBufferlessInputStream() . aşırı yükleme.