IBrowserFile.OpenReadStream(Int64, CancellationToken) Metoda

Definice

Obor názvů:

Microsoft.AspNetCore.Components.Forms

Sestavení:

Microsoft.AspNetCore.Components.Web.dll

Balíček:

Microsoft.AspNetCore.Components.Web v8.0.0

Zdroj:

IBrowserFile.cs

Otevře datový proud pro čtení nahraného souboru.

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

Parametry

maxAllowedSize

Int64

Maximální počet bajtů, které může stream zadat. Výchozí hodnota je 500 kB.

Volání OpenReadStream(Int64, CancellationToken) vyvolá, pokud je velikost souboru, jak je určená parametrem Size , větší než maxAllowedSize. Ve výchozím nastavení, pokud uživatel dodá soubor větší než 500 kB, tato metoda vyvolá výjimku.

Je užitečné zvolit limit velikosti, který odpovídá vašemu případu použití. Pokud povolíte příliš velké soubory, může to mít za následek nadměrné využití paměti nebo místa na disku nebo databázi v závislosti na tom, co váš kód dělá se zadaným Streamsouborem .

Zejména pro Blazor Server si dávejte pozor na čtení celého datového proudu do vyrovnávací paměti, pokud jste nepřešli dostatečně nízký limit velikosti, protože tuto paměť budete na serveru využívat.

cancellationToken

CancellationToken

Token pro zrušení, který signalizují zrušení dat streamovaných souborů.

Návraty

Stream

Výjimky

IOException

Vyvolá se, pokud délka souboru překročí maxAllowedSize hodnotu.