IBrowserFile.OpenReadStream(Int64, CancellationToken) 方法

定义

命名空间:

Microsoft.AspNetCore.Components.Forms

程序集:

Microsoft.AspNetCore.Components.Web.dll

包:

Microsoft.AspNetCore.Components.Web v8.0.0

打开流以读取上传的文件。

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

流可以提供的最大字节数。 默认为 500 KB。

如果指定的文件的大小Size大于 maxAllowedSize，则调用 OpenReadStream(Int64, CancellationToken) 将引发 。 默认情况下，如果用户提供的文件大于 500 KB，此方法将引发异常。

选择与用例对应的大小限制很有价值。 如果允许过大的文件，这可能会导致内存或磁盘/数据库空间过度消耗，具体取决于代码对提供的 Stream执行的操作。

特别是对于 Blazor 服务器，请注意将整个流读取到内存缓冲区中，除非你通过了适当的较小大小限制，因为你将在服务器上使用该内存。

cancellationToken

CancellationToken

一个取消令牌，用于发出取消流文件数据的信号。

返回

Stream

例外

IOException

如果文件的长度超过 值， maxAllowedSize 则引发。