IBrowserFile.OpenReadStream(Int64, CancellationToken) Methode

Definition

Namespace:

Microsoft.AspNetCore.Components.Forms

Assembly:

Microsoft.AspNetCore.Components.Web.dll

Paket:

Microsoft.AspNetCore.Components.Web v8.0.0

Öffnet den Stream zum Lesen der hochgeladenen Datei.

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

Parameter

maxAllowedSize

Int64

Die maximale Anzahl von Bytes, die vom Stream bereitgestellt werden kann. Standardwert ist 500 KB.

Beim Aufrufen OpenReadStream(Int64, CancellationToken) wird ausgelöst, wenn die Dateigröße größer als maxAllowedSizeist.Size Wenn der Benutzer standardmäßig eine Datei bereitstellt, die größer als 500 KB ist, löst diese Methode eine Ausnahme aus.

Es ist hilfreich, eine Größenbegrenzung zu wählen, die Ihrem Anwendungsfall entspricht. Wenn Sie übermäßig große Dateien zulassen, kann dies zu einer übermäßigen Auslastung von Arbeitsspeicher oder Speicherplatz auf der Festplatte/Datenbank führen, je nachdem, was Ihr Code mit dem angegebenen Streammacht.

Achten Sie insbesondere bei Blazor Server darauf, den gesamten Stream in einen Speicherpuffer zu lesen, es sei denn, Sie haben ein entsprechend niedriges Größenlimit überschritten, da Sie diesen Arbeitsspeicher auf dem Server verbrauchen.

cancellationToken

CancellationToken

Ein Abbruchtoken zum Signalisieren des Abbruchs von Streamingdateidaten.

Gibt zurück

Stream

Ausnahmen

IOException

Wird ausgelöst, wenn die Dateilänge den maxAllowedSize Wert überschreitet.