Partager via


IBrowserFile.OpenReadStream(Int64, CancellationToken) Méthode

Définition

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

Exceptions

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

S’applique à