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 aktuellen 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 MemoryStream
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
Der Wert, auf den die Länge festgelegt werden soll.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die Größe des aktuellen Streams kann nicht geändert werden, und value übersteigt die aktuelle Kapazität. – oder – Der aktuelle Stream unterstützt keine Schreibvorgänge. |
|
value ist negativ oder größer als die maximale Länge von MemoryStream, wobei die maximale Länge (MaxValue - Ursprung) ist, und der Ursprung der Index des zugrunde liegenden Puffers ist, an dem der Stream beginnt. |
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.
Diese Methode überschreibt SetLength.
Wenn der angegebene Wert kleiner als die aktuelle Länge des Streams ist, wird der Stream abgeschnitten. Wenn sich die aktuelle Position im Stream nach dem Abschneiden hinter dem Ende des Streams befindet, gibt die ReadByte-Methode -1 zurück, die Read-Methode liest 0 Bytes in das bereitgestellte Bytearray und die Write-Methode sowie die WriteByte-Methode fügen angegebene Bytes an das Ende des Streams an, wodurch dieser verlängert wird. Wenn der angegebene Wert größer als die aktuelle Kapazität ist und die Größe des Streams geändert werden kann, wird die Kapazität erhöht und die aktuelle Position im Stream bleibt unverändert. Wenn die Länge erhöht wird, dann wird der Inhalt des Streams zwischen der alten und der neuen Länge mit Nullen initialisiert.
Hinweis
Damit diese Methode ordnungsgemäß ausgeführt wird, muss eine MemoryStream-Instanz Schreibvorgänge unterstützen. Verwenden Sie die CanWrite-Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstützt. Weitere Informationen finden Sie unter CanWrite.
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
MemoryStream-Klasse
MemoryStream-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