IBrowserFile.OpenReadStream(Int64, CancellationToken) Metoda

Reference

Definice

Obor názvů:: Microsoft.AspNetCore.Components.Forms

Sestavení:: Microsoft.AspNetCore.Components.Web.dll

Balíček:: Microsoft.AspNetCore.Components.Web v5.0.9

Balíček:: Microsoft.AspNetCore.Components.Web v6.0.6

Balíček:: Microsoft.AspNetCore.Components.Web v7.0.0-preview.5.22303.8

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Otevře stream 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četch Výchozí hodnota je 500 kB.

Volání OpenReadStream(Int64, CancellationToken) vyvolá, pokud je velikost souboru větší než Size maxAllowedSize. Pokud uživatel ve výchozím nastavení zadá soubor větší než 500 kB, vyvolá tato metoda 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 vést k nadměrné spotřebě paměti nebo místa na disku nebo databázi v závislosti na tom, co váš kód dělá se zadaným Streamkódem .

Pro Blazor Server si zejména dávejte pozor na čtení celého datového proudu do vyrovnávací paměti, pokud jste nepředáli vhodné omezení velikosti, protože budete tuto paměť na serveru využívat.

cancellationToken: CancellationToken

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

Návraty

Stream

Výjimky

IOException

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

Platí pro