Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Legt die Länge des gepufferten Streams fest.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Overrides Sub SetLength ( _
value As Long _
)
'Usage
Dim instance As BufferedStream
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
Eine ganze Zahl, die die gewünschte Länge des aktuellen gepufferten Streams in Bytes angibt.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
value ist negativ. |
|
Der Stream ist nicht geöffnet oder ist NULL (Nothing in Visual Basic). |
|
Der Stream unterstützt weder Schreib- noch Suchvorgänge. |
|
Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde. |
Hinweise
Ein Beispiel für das Erstellen einer Datei und das Schreiben von Text in eine Datei finden Sie unter Gewusst wie: Schreiben von Text in eine Datei. Ein Beispiel für das Lesen von Text aus einer Datei finden Sie unter Gewusst wie: Lesen aus einer Textdatei. Ein Beispiel für das Lesen aus einer Binärdatei und das Schreiben in eine Binärdatei finden Sie unter Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei.
Der Puffer wird entleert, bevor die Länge der zugrunde liegenden Datenquelle oder des Repositorys festgelegt wird. Wenn der angegebene Wert kleiner als die aktuelle Länge des gepufferten Streams ist, wird der gepufferte Stream abgeschnitten. Wenn der angegebene Wert größer als die aktuelle Länge des gepufferten Streams ist, wird der gepufferte Stream erweitert. Wenn der gepufferte Stream erweitert wird, ist der Inhalt des gepufferten Streams zwischen der alten und der neuen Länge undefiniert.
SetLength schreibt bei Bedarf alle gepufferten Schreibvorgänge weg.
Ein Stream muss Schreib- und Suchvorgänge unterstützen, damit SetLength ausgeführt werden kann.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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
Siehe auch
Referenz
BufferedStream-Klasse
BufferedStream-Member
System.IO-Namespace
Seek
Weitere Ressourcen
Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei