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

Максимальное число байтов, которое может быть предоставлено потоком. Значение по умолчанию — 500 КБ.

Вызов OpenReadStream(Int64, CancellationToken) вызовет исключение, если размер файла, как указано в параметре SizemaxAllowedSize, больше . По умолчанию, если пользователь предоставляет файл размером более 500 КБ, этот метод создает исключение.

Полезно выбрать ограничение размера, соответствующее вашему варианту использования. Если разрешить слишком большие файлы, это может привести к чрезмерному потреблению памяти или места на диске или базе данных в зависимости от того, что ваш код делает с предоставленным Stream.

Для Blazor Server, в частности, остерегайтесь считывания всего потока в буфер памяти, если вы не прошли соответствующее низкое ограничение размера, так как вы будете потреблять эту память на сервере.

cancellationToken

CancellationToken

Маркер отмены, который сигнализирует об отмене потоковой передачи данных файлов.

Возвращаемое значение

Stream

Исключения

IOException

Возникает, если длина файла превышает maxAllowedSize значение .