FileStream.SetLength-Methode

Artikel
08/20/2007

Legt die Länge dieses Streams auf den angegebenen Wert fest.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overrides Sub SetLength ( _
    value As Long _
)
'Usage
Dim instance As FileStream
Dim value As Long

instance.SetLength(value)

public override void SetLength (
    long value
)

public:
virtual void SetLength (
    long long value
) override

public void SetLength (
    long value
)

public override function SetLength (
    value : long
)

Parameter

value
Die neue Länge des Streams.

Ausnahmen

Ausnahmetyp	Bedingung
IOException	Ein E/A-Fehler ist aufgetreten.
NotSupportedException	Der Stream unterstützt weder Schreib- noch Suchvorgänge.
ArgumentOutOfRangeException	Es wurde versucht, den value-Parameter auf einen kleineren Wert als 0 festzulegen.

Hinweise

Diese Methode überschreibt SetLength.

Wenn der angegebene Wert kleiner als die aktuelle Länge des Streams ist, wird der Stream abgeschnitten. Wenn der angegebene Wert größer als die aktuelle Länge des Streams ist, wird der Stream erweitert. Wenn der Stream erweitert wird, ist der Inhalt des Streams zwischen der alten und der neuen Länge undefiniert.

Ein Stream muss Schreib- und Suchvorgänge unterstützen, damit SetLength ausgeführt werden kann.

Hinweis

Bestimmen Sie mithilfe der CanWrite-Eigenschaft, ob die aktuelle Instanz Schreibvorgänge unterstützt, und mithilfe der CanSeek-Eigenschaft, ob Suchvorgänge unterstützt werden. Weitere Informationen finden Sie unter CanWrite und CanSeek.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe	Beispiel in diesem Thema
Erstellen einer Textdatei.	Gewusst wie: Schreiben von Text in eine Datei
In eine Textdatei schreiben.	Gewusst wie: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	Gewusst wie: Lesen aus einer Textdatei
Text an eine Datei anfügen.	Gewusst wie: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Eine Datei umbenennen oder verschieben.	File.Move FileInfo.MoveTo
Eine Datei kopieren.	File.Copy FileInfo.CopyTo
Die Größe eines Verzeichnisses abrufen.	FileInfo.Length
Die Attribute einer Datei abrufen.	File.GetAttributes
Die Attribute einer Datei festlegen.	File.SetAttributes
Ein Unterverzeichnis erstellen.	CreateSubdirectory
Aus einer Binärdatei lesen.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
In eine Binärdatei schreiben.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
Die Dateien in einem Verzeichnis anzeigen.	Name
Die Dateien in einem Verzeichnis nach Größe sortieren.	GetFileSystemInfos

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

FileStream-Klasse
FileStream-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei

Freigeben über