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

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:

Weitere Informationen