FileStream.SetLength(Int64) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic Overrides Sub SetLength (value As Long)Parameter
- value
- Int64
Die neue Länge des Streams.
Ausnahmen
Ein E/A-Fehler ist aufgetreten.
Der Stream unterstützt nicht gleichzeitig Schreib- und Suchvorgänge.
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.
