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 -> unit
Public 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 gegebene Wert kleiner als die aktuelle Länge des Streams ist, wird der Stream abgeschnitten. Wenn die aktuelle Position in diesem Szenario größer als die neue Länge ist, wird die aktuelle Position in das letzte Byte des Streams verschoben. Wenn der gegebene Wert größer als die aktuelle Länge des Streams ist, wird der Stream erweitert, und die aktuelle Position bleibt unverändert. Wenn der Stream erweitert wird, ist der Inhalt des Streams zwischen der alten und der neuen Länge in Windows nicht definiert, während unter Linux dieser Bereich mit Nullen gefüllt wird.
Ein Stream muss sowohl das Schreiben als auch das Suchen nach SetLength
unterstützen, damit er funktioniert.
Hinweis
Verwenden Sie die -Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Das Schreiben unterstützt, und die -Eigenschaft, um zu CanWrite bestimmen, CanSeek ob Such such-Unterstützung 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.