IBrowserFile.OpenReadStream(Int64, CancellationToken) 方法

定義

命名空間:

Microsoft.AspNetCore.Components.Forms

組件:

Microsoft.AspNetCore.Components.Web.dll

套件:

Microsoft.AspNetCore.Components.Web v8.0.0

來源:

IBrowserFile.cs

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

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

表示取消串流檔案資料的解除標記。

傳回

Stream

例外狀況

IOException

如果檔案的長度超過 maxAllowedSize 值，則會擲回 。