IBrowserFile.OpenReadStream(Int64, CancellationToken) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.StreamPublic Function OpenReadStream (Optional maxAllowedSize As Long = 512000, Optional cancellationToken As CancellationToken = Nothing) As StreamParâ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
Exceções
Gerado se o comprimento do arquivo exceder o maxAllowedSize valor.