IBrowserFile.OpenReadStream(Int64, CancellationToken) Metoda

Definicja

Przestrzeń nazw:

Microsoft.AspNetCore.Components.Forms

Zestaw:

Microsoft.AspNetCore.Components.Web.dll

Pakiet:

Microsoft.AspNetCore.Components.Web v8.0.0

Źródło:

IBrowserFile.cs

Otwiera strumień do odczytywania przekazanego pliku.

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

Maksymalna liczba bajtów, które mogą być dostarczane przez usługę Stream. Wartość domyślna to 500 KB.

Wywołanie wywołania OpenReadStream(Int64, CancellationToken) spowoduje zgłoszenie, jeśli rozmiar pliku określony przez Size parametr jest większy niż maxAllowedSize. Domyślnie jeśli użytkownik dostarczy plik większy niż 500 KB, ta metoda zgłosi wyjątek.

Warto wybrać limit rozmiaru odpowiadający twojemu przypadku użycia. Jeśli zezwalasz na zbyt duże pliki, może to spowodować nadmierne zużycie pamięci lub miejsca na dysku/bazie danych, w zależności od tego, co robi kod z podanym Streamkodem .

W szczególności w przypadku serwera Blazor należy pamiętać o odczytywaniu całego strumienia do bufora pamięci, chyba że upłynął odpowiednio niski limit rozmiaru, ponieważ będzie zużywać tej pamięci na serwerze.

cancellationToken

CancellationToken

Token anulowania w celu zasygnalizowania anulowania danych pliku przesyłania strumieniowego.

Zwraca

Stream

Wyjątki

IOException

Zgłaszany, jeśli długość pliku przekracza maxAllowedSize wartość.