FileStream.SetLength(Int64) Méthode

  • Référence

Définition

Espace de noms:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
FileStream.cs
Source:
FileStream.cs
Source:
FileStream.cs

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 -> unit
Public Overrides Sub SetLength (value As Long)

Paramètres

value
Int64

Nouvelle longueur du flux.

Exceptions

IOException

Une erreur d’E/S s’est produite.

NotSupportedException

Le flux ne prend pas en charge l’écriture et la recherche.

ArgumentOutOfRangeException

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.

S’applique à

Voir aussi