UnmanagedMemoryStream.SetLength(Int64) Methode

Definition

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

Ein E/A-Fehler ist aufgetreten.

Der Stream ist geschlossen.

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

- oder -

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

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 Stream abgeschnitten. Wenn der angegebene Wert größer als die aktuelle Länge des Datenstroms ist, wird der Stream erweitert. Wenn der Stream erweitert wird, ist der Inhalt des Datenstroms zwischen der alten und der neuen Länge nicht definiert.

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

Gilt für: