MemoryStream.Write-Methode

Artikel
08/20/2007

Schreibt einen Byteblock mit den aus dem Puffer gelesenen Daten in den aktuellen Stream.

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

Syntax

'Declaration
Public Overrides Sub Write ( _
    buffer As Byte(), _
    offset As Integer, _
    count As Integer _
)
'Usage
Dim instance As MemoryStream
Dim buffer As Byte()
Dim offset As Integer
Dim count As Integer

instance.Write(buffer, offset, count)

public override void Write (
    byte[] buffer,
    int offset,
    int count
)

public:
virtual void Write (
    array<unsigned char>^ buffer, 
    int offset, 
    int count
) override

public void Write (
    byte[] buffer, 
    int offset, 
    int count
)

public override function Write (
    buffer : byte[], 
    offset : int, 
    count : int
)

Parameter

buffer
Der Puffer, aus dem Daten geschrieben werden sollen.

offset
Der Byteoffset im buffer, ab dem aus dem Puffer geschrieben werden soll.

count
Die maximale Anzahl der zu schreibenden Bytes.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	buffer ist NULL (Nothing in Visual Basic).
NotSupportedException	Der Stream unterstützt keine Schreibvorgänge. Weitere Informationen finden Sie unter CanWrite. – oder – Der Abstand der aktuellen Position zum Ende des Streams beträgt weniger als count Bytes, und die Kapazität kann nicht geändert werden.
ArgumentException	offset subtrahiert von der Pufferlänge ist kleiner als count.
ArgumentOutOfRangeException	offset oder count ist negativ.
IOException	Ein E/A-Fehler ist aufgetreten.
ObjectDisposedException	Der aktuelle Instanz des Streams ist geschlossen.

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 Write.

Der offset-Parameter gibt den Offset des ersten Bytes in buffer an, aus dem geschrieben werden soll, und der count-Parameter gibt die Anzahl der zu schreibenden Bytes an. Wenn der Schreibvorgang erfolgreich ist, wird die aktuelle Position im Stream um die Anzahl der geschriebenen Bytes erhöht. Wenn eine Ausnahme eintritt, wird die aktuelle Position im Stream nicht geändert.

Schreibvorgänge am Ende eines MemoryStream erweitern den MemoryStream, sofern der MemoryStream nicht mit einem byte[]-Parameter erstellt wurde.

Beispiel

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die MemoryStream-Klasse.

' Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length)

// Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length);

// Write the first string to the stream.
memStream->Write( firstString, 0, firstString->Length );

// Write the first string to the stream.
memStream.Write(firstString, 0, firstString.length);

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

Share via