IBrowserFile.OpenReadStream(Int64, CancellationToken) Método

Definição

Namespace:

Microsoft.AspNetCore.Components.Forms

Assembly:

Microsoft.AspNetCore.Components.Web.dll

Pacote:

Microsoft.AspNetCore.Components.Web v9.0.0

Origem:

IBrowserFile.cs

Abre o fluxo para ler o arquivo carregado.

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

O número máximo de bytes que podem ser fornecidos pelo Stream. O padrão é 500 KB.

A chamada OpenReadStream(Int64, CancellationToken) será gerada se o tamanho do arquivo, conforme especificado por Size for maior que maxAllowedSize. Por padrão, se o usuário fornecer um arquivo maior que 500 KB, esse método gerará uma exceção.

É importante escolher um limite de tamanho que corresponda ao seu caso de uso. Se você permitir arquivos excessivamente grandes, isso poderá resultar em consumo excessivo de memória ou espaço em disco/banco de dados, dependendo do que o código faz com o fornecido Stream.

Para o Blazor Server em particular, tenha cuidado com a leitura de todo o fluxo em um buffer de memória, a menos que você tenha passado um limite de tamanho adequadamente baixo, pois você consumirá essa memória no servidor.

cancellationToken

CancellationToken

Um token de cancelamento para sinalizar o cancelamento de dados de arquivo de streaming.

Retornos

Stream

Exceções

IOException

Gerado se o comprimento do arquivo exceder o maxAllowedSize valor.