MemoryStream.Write MemoryStream.Write MemoryStream.Write MemoryStream.Write Method

Definition

Überlädt

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)
Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Schreibt einen Byteblock mit den aus einem Puffer gelesenen Daten in den aktuellen Stream.Writes a block of bytes to the current stream using data read from a buffer.

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)

public:
 override void Write(ReadOnlySpan<System::Byte> source);
public override void Write (ReadOnlySpan<byte> source);
override this.Write : ReadOnlySpan<byte> -> unit
Public Overrides Sub Write (source As ReadOnlySpan(Of Byte))

Parameter

source
ReadOnlySpan<Byte>

Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Schreibt einen Byteblock mit den aus einem Puffer gelesenen Daten in den aktuellen Stream.Writes a block of bytes to the current stream using data read from a buffer.

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.The buffer to write data from.

offset
Int32 Int32 Int32 Int32

Der nullbasierte Byteoffset im buffer, ab dem Bytes in den aktuellen Stream kopiert werden.The zero-based byte offset in buffer at which to begin copying bytes to the current stream.

count
Int32 Int32 Int32 Int32

Die maximale Anzahl der zu schreibenden Bytes.The maximum number of bytes to write.

Ausnahmen

Der Stream unterstützt das Schreiben nicht.The stream does not support writing. Weitere Informationen finden Sie unter CanWrite.For additional information see CanWrite.

- oder --or- Der Abstand der aktuellen Position zum Ende des Streams beträgt weniger als count Bytes, und die Kapazität kann nicht geändert werden.The current position is closer than count bytes to the end of the stream, and the capacity cannot be modified.

offset subtrahiert von der Pufferlänge ist kleiner als count.offset subtracted from the buffer length is less than count.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Der aktuelle Instanz des Streams ist geschlossen.The current stream instance is closed.

Beispiele

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die MemoryStream Klasse.This code example is part of a larger example provided for the MemoryStream class.

// 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.This method overrides Write.

Die offset Parameter gibt den Offset des ersten Bytes in buffer zum Schreiben von aus, und die count -Parameter gibt die Anzahl der zu schreibenden Bytes.The offset parameter gives the offset of the first byte in buffer to write from, and the count parameter gives the number of bytes to write. Wenn der Schreibvorgang erfolgreich ist, wird die aktuelle Position im Stream um die Anzahl der geschriebenen Bytes erweitert.If the write operation is successful, the current position within the stream is advanced by the number of bytes written. Wenn eine Ausnahme auftritt, wird die aktuelle Position im Stream nicht geändert.If an exception occurs, the current position within the stream is unchanged.

Mit Ausnahme von einer MemoryStream erstellt mit einem Byte []-Parameter, Schreibvorgänge am Ende einer MemoryStream erweitern Sie die MemoryStream.Except for a MemoryStream constructed with a byte[] parameter, write operations at the end of a MemoryStream expand the MemoryStream.

Siehe auch

Gilt für: