FileStream.SetLength(Int64) 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.
Définit la longueur de ce flux à la valeur donnée.
public:
override void SetLength(long value);public override void SetLength (long value);override this.SetLength : int64 -> unitPublic Overrides Sub SetLength (value As Long)Paramètres
- value
- Int64
Nouvelle longueur du flux.
Exceptions
Une erreur d’E/S s’est produite.
Le flux ne prend pas en charge l’écriture et la recherche.
Tentative de définir le paramètre value sur une valeur inférieure à 0.
Remarques
Cette méthode se substitue à SetLength.
Si la valeur donnée est inférieure à la longueur actuelle du flux, le flux est tronqué. Dans ce scénario, si la position actuelle est supérieure à la nouvelle longueur, la position actuelle est déplacée vers le dernier octet du flux. Si la valeur donnée est supérieure à la longueur actuelle du flux, le flux est développé et la position actuelle reste la même. Si le flux est développé, le contenu du flux entre l’ancien et la nouvelle longueur n’est pas défini sur Windows, tandis que sur Linux, cet espace est rempli de zéros.
Un flux doit prendre en charge à la fois l’écriture et la recherche de SetLength travail.
Notes
Utilisez la CanWrite propriété pour déterminer si le instance actuel prend en charge l’écriture, et la propriété pour déterminer si la CanSeek recherche est prise en charge. Pour plus d'informations, consultez CanWrite et CanSeek.
Pour obtenir la liste des opérations courantes de fichiers et de répertoires, consultez Tâches courantes d’E/S.
