IBrowserFile.OpenReadStream(Int64, CancellationToken) Metodo

Definizione

Spazio dei nomi:

Microsoft.AspNetCore.Components.Forms

Assembly:

Microsoft.AspNetCore.Components.Web.dll

Pacchetto:

Microsoft.AspNetCore.Components.Web v8.0.0

Origine:

IBrowserFile.cs

Apre il flusso per la lettura del file caricato.

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

Parametri

maxAllowedSize

Int64

Numero massimo di byte che possono essere forniti dal flusso. Il valore predefinito è 500 KB.

La chiamata OpenReadStream(Int64, CancellationToken) genererà se la dimensione del file, come specificato da Size è maggiore di maxAllowedSize. Per impostazione predefinita, se l'utente fornisce un file maggiore di 500 KB, questo metodo genererà un'eccezione.

È utile scegliere un limite di dimensioni corrispondente al caso d'uso. Se si consentono file eccessivamente di grandi dimensioni, questo può comportare un consumo eccessivo di spazio di memoria o disco/database, a seconda di ciò che il codice fa con l'oggetto fornito Stream.

Per Blazor Server in particolare, tenere presente che leggere l'intero flusso in un buffer di memoria a meno che non sia stato superato un limite di dimensioni adeguatamente basso, poiché si sta consumando tale memoria nel server.

cancellationToken

CancellationToken

Token di annullamento per segnalare l'annullamento dei dati dei file di streaming.

Restituisce

Stream

Eccezioni

IOException

Generato se la lunghezza del file supera il maxAllowedSize valore.