FileStream.SetLength(Int64) Methode

  • Referenz

Definition

Namespace:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
FileStream.cs
Quelle:
FileStream.cs
Quelle:
FileStream.cs

Legt die Länge dieses Streams auf den angegebenen Wert fest.

public:
 override void SetLength(long value);
public override void SetLength (long value);
override this.SetLength : int64 -> unit
Public Overrides Sub SetLength (value As Long)

Parameter

value
Int64

Die neue Länge des Streams.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

NotSupportedException

Der Stream unterstützt nicht gleichzeitig Schreib- und Suchvorgänge.

ArgumentOutOfRangeException

Es wurde versucht, den value-Parameter auf einen Wert kleiner 0 (null) festzulegen.

Hinweise

Diese Methode überschreibt SetLength.

Wenn der angegebene Wert kleiner als die aktuelle Länge des Datenstroms ist, wird der Stream abgeschnitten. Wenn in diesem Szenario die aktuelle Position größer als die neue Länge ist, wird die aktuelle Position in das letzte Byte des Datenstroms verschoben. Wenn der angegebene Wert größer als die aktuelle Länge des Datenstroms ist, wird der Stream erweitert, und die aktuelle Position bleibt gleich. Wenn der Stream erweitert wird, ist der Inhalt des Datenstroms zwischen der alten und der neuen Länge unter Windows nicht definiert, während unter Linux dieser Bereich mit Nullen gefüllt ist.

Ein Stream muss sowohl das Schreiben als auch die Suche unterstützen SetLength , um zu arbeiten.

Hinweis

Verwenden Sie die CanWrite -Eigenschaft, um zu bestimmen, ob die aktuelle instance das Schreiben unterstützt, und die CanSeek -Eigenschaft, um zu bestimmen, ob suchen unterstützt wird. Weitere Informationen finden Sie unter CanWrite und CanSeek.

Eine Liste der allgemeinen Datei- und Verzeichnisvorgänge finden Sie unter Allgemeine E/A-Aufgaben.

Gilt für:

Weitere Informationen