Auf Englisch lesen

Freigeben über


MemoryStream.Write Methode

Definition

Ü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
Quelle:
MemoryStream.cs
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.

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

Parameter

sourcebuffer
ReadOnlySpan<Byte>

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

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Write(Byte[], Int32, Int32)

Quelle:
MemoryStream.cs
Quelle:
MemoryStream.cs
Quelle:
MemoryStream.cs

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

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

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

buffer ist null.

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.

offset subtrahiert von der Pufferlänge ist kleiner als count.

offset oder count ist negativ.

Ein E/A-Fehler tritt auf.

Der aktuelle Instanz des Streams ist geschlossen.

Beispiele

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

C#
// 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

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0