IBrowserFile.OpenReadStream(Int64, CancellationToken) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
開啟資料流程以讀取上傳的檔案。
public System.IO.Stream OpenReadStream (long maxAllowedSize = 512000, System.Threading.CancellationToken cancellationToken = default);abstract member OpenReadStream : int64 * System.Threading.CancellationToken -> System.IO.StreamPublic Function OpenReadStream (Optional maxAllowedSize As Long = 512000, Optional cancellationToken As CancellationToken = Nothing) As Stream參數
- maxAllowedSize
- Int64
Stream 可以提供的最大位元組數目。 預設值為 500 KB。
如果檔案的大小大於 ， SizemaxAllowedSize 則呼叫 OpenReadStream(Int64, CancellationToken) 會擲回 。 根據預設，如果使用者提供大於 500 KB 的檔案，這個方法將會擲回例外狀況。
選擇對應至使用案例的大小限制非常重要。 如果您允許太大的檔案，這可能會導致記憶體或磁片/資料庫空間過度耗用，視您的程式碼對所提供的 Stream 執行作業而定。
特別是對於 Blazor Server，請務必將整個資料流程讀取到記憶體緩衝區，除非您已傳遞適當大小限制，因為您將耗用伺服器上的該記憶體。
- cancellationToken
- CancellationToken
表示取消串流檔案資料的解除標記。
傳回
例外狀況
如果檔案的長度超過 maxAllowedSize 值，則會擲回 。