Stream.SetLength(Int64) Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: Stream.cs

Quelle:: Stream.cs

Quelle:: Stream.cs

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 beim Überschreiben in einer abgeleiteten Klasse die Länge des aktuellen Streams fest.

public:
 abstract void SetLength(long value);

public abstract void SetLength (long value);

abstract member SetLength : int64 -> unit

Public MustOverride Sub SetLength (value As Long)

Parameter

value: Int64

Die gewünschte Länge des aktuellen Streams in Bytes.

Ausnahmen

IOException

Ein E/A-Fehler tritt auf.

NotSupportedException

Der Stream unterstützt nicht sowohl Lese- als auch Schreibvorgänge. Dies ist beispielsweise der Fall, wenn der Stream aus einer Pipe- oder Konsolenausgabe erstellt wird.

ObjectDisposedException

Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.

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, wird der Inhalt des Datenstroms zwischen der alten und der neuen Länge nicht definiert.

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

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.

Gilt für:

Freigeben über