IBrowserFile.OpenReadStream(Int64, CancellationToken) Método

Definición

Espacio de nombres:

Microsoft.AspNetCore.Components.Forms

Ensamblado:

Microsoft.AspNetCore.Components.Web.dll

Paquete:

Microsoft.AspNetCore.Components.Web v8.0.0

Abre la secuencia para leer el archivo cargado.

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

Parámetros

maxAllowedSize

Int64

Número máximo de bytes que puede proporcionar stream. El valor predeterminado es 500 KB.

Al llamar a OpenReadStream(Int64, CancellationToken) se producirá si el tamaño del archivo, según lo especificado por Size es mayor que maxAllowedSize. De forma predeterminada, si el usuario proporciona un archivo de más de 500 KB, este método producirá una excepción.

Es útil elegir un límite de tamaño que corresponda a su caso de uso. Si permite archivos demasiado grandes, esto puede dar lugar a un consumo excesivo de memoria o espacio en disco o base de datos, en función de lo que haga el código con el proporcionado Stream.

En el caso de Blazor Server en particular, tenga en cuenta la lectura de toda la secuencia en un búfer de memoria a menos que haya superado un límite de tamaño adecuado, ya que consumirá esa memoria en el servidor.

cancellationToken

CancellationToken

Token de cancelación para indicar la cancelación de los datos del archivo de streaming.

Devoluciones

Stream

Excepciones

IOException

Se produce si la longitud del archivo supera el maxAllowedSize valor.