共用方式為


IBrowserFile.OpenReadStream(Int64, CancellationToken) 方法

定義

開啟資料流程以讀取上傳的檔案。

public System.IO.Stream OpenReadStream (long maxAllowedSize = 512000, System.Threading.CancellationToken cancellationToken = default);
abstract member OpenReadStream : int64 * System.Threading.CancellationToken -> System.IO.Stream
Public 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 值,則會擲回 。

適用於