MemoryStream.Write Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Überlädt

Write(ReadOnlySpan<Byte>)	Schreibt die Bytesequenz, die in source enthalten ist, in den aktuellen Speicherdatenstrom und setzt die aktuelle Position in diesem Speicherdatenstrom um die Anzahl der geschriebenen Bytes nach vorn.
Write(Byte[], Int32, Int32)	Schreibt einen Byteblock mit den aus einem Puffer gelesenen Daten in den aktuellen Stream.

Write(ReadOnlySpan<Byte>)

Quelle:

MemoryStream.cs

Schreibt die Bytesequenz, die in source enthalten ist, in den aktuellen Speicherdatenstrom und setzt die aktuelle Position in diesem Speicherdatenstrom um die Anzahl der geschriebenen Bytes nach vorn.

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);

public override void Write (ReadOnlySpan<byte> buffer);

override this.Write : ReadOnlySpan<byte> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Parameter

buffer

ReadOnlySpan<Byte>

Ein Bereich im Arbeitsspeicher. Diese Methode kopiert den Inhalt dieses Bereichs in den aktuellen Speicherdatenstrom.

Write(Byte[], Int32, Int32)

Quelle:

MemoryStream.cs

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

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

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

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parameter

buffer

Byte[]

Der Puffer, aus dem Daten geschrieben werden sollen.

offset

Int32

Der nullbasierte Byteoffset im buffer, ab dem Bytes in den aktuellen Stream kopiert werden.

count

Int32

Die maximale Anzahl der zu schreibenden Bytes.

Ausnahmen

ArgumentNullException

buffer ist null.

NotSupportedException

Der Stream unterstützt das Schreiben nicht. 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 tritt auf.

ObjectDisposedException

Der aktuelle Instanz des Streams ist geschlossen.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die MemoryStream-Klasse bereitgestellt wird.

// 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)

Hinweise

Diese Methode überschreibt Write.

Der offset Parameter gibt den Offset des ersten Byte 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 erweitert. Wenn eine Ausnahme auftritt, ist die aktuelle Position im Stream unverändert.

Mit Ausnahme eines MemoryStream mit einem byte[]-Parameter erstellten Parameters, schreiben Sie Vorgänge am Ende eines MemoryStream Erweiterns von MemoryStream.

Weitere Informationen

• Datei- und Stream-E/A
• How to: Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei