IBrowserFile.OpenReadStream(Int64, CancellationToken) Méthode

Définition

Espace de noms:

Microsoft.AspNetCore.Components.Forms

Assembly:

Microsoft.AspNetCore.Components.Web.dll

Paquet:

Microsoft.AspNetCore.Components.Web v8.0.0

Source:

IBrowserFile.cs

Ouvre le flux de lecture du fichier chargé.

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

Paramètres

maxAllowedSize

Int64

Nombre maximal d’octets pouvant être fournis par le flux. La valeur par défaut est de 500 Ko.

L’appel OpenReadStream(Int64, CancellationToken) se lève si la taille du fichier, telle que spécifiée par Size , est supérieure à maxAllowedSize. Par défaut, si l’utilisateur fournit un fichier supérieur à 500 Ko, cette méthode lève une exception.

Il est utile de choisir une limite de taille qui correspond à votre cas d’usage. Si vous autorisez des fichiers trop volumineux, cela peut entraîner une consommation excessive de mémoire ou d’espace disque/base de données, selon ce que votre code fait avec le fourni Stream.

Pour Blazor Server en particulier, veillez à lire l’intégralité du flux dans une mémoire tampon, sauf si vous avez dépassé une limite de taille convenablement faible, car vous consommerez cette mémoire sur le serveur.

cancellationToken

CancellationToken

Jeton d’annulation pour signaler l’annulation des données de fichier de streaming.

Retours

Stream

Exceptions

IOException

Levée si la longueur du fichier dépasse la maxAllowedSize valeur.