UnmanagedMemoryStream.SetLength(Int64) Methode

Referenz

Definition

Namespace:: System.IO

Assemblys:: mscorlib.dll, System.IO.UnmanagedMemoryStream.dll

Assembly:: System.Runtime.dll

Assembly:: System.IO.UnmanagedMemoryStream.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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 eines Streams auf einen 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 Länge des Datenstroms.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

ObjectDisposedException

Der Stream ist geschlossen.

NotSupportedException

Der zugrunde liegende Speicher unterstützt keine Schreibvorgänge.

- oder - Es wird versucht, in den Stream zu schreiben, und die CanWrite-Eigenschaft ist false.

ArgumentOutOfRangeException

Der angegebene value übersteigt die Kapazität des Streams.

- oder - Der angegebene value ist negativ.

Hinweise

Wenn der angegebene Wert kleiner als die aktuelle Länge des Datenstroms ist, wird der Datenstrom abgeschnitten. Wenn der angegebene Wert größer als die aktuelle Länge des Datenstroms ist, wird der Datenstrom erweitert. Wenn der Datenstrom erweitert wird, werden die Inhalte des Datenstroms zwischen der alten und den neuen Längen nicht definiert.

Ein Datenstrom muss sowohl das Schreiben als auch das Arbeiten SetLength unterstützen.

Gilt für