IBrowserFile.OpenReadStream(Int64, CancellationToken) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.