Stream.Write Method

Definition

Overloads

Write(ReadOnlySpan<Byte>)

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Folge von Bytes in den aktuellen Stream und erhöht die aktuelle Position im Stream um die Anzahl der geschriebenen Bytes.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

Write(Byte[], Int32, Int32)

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Folge von Bytes in den aktuellen Stream und erhöht die aktuelle Position im Stream um die Anzahl der geschriebenen Bytes.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

Write(ReadOnlySpan<Byte>)

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Folge von Bytes in den aktuellen Stream und erhöht die aktuelle Position im Stream um die Anzahl der geschriebenen Bytes.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

public:
 virtual void Write(ReadOnlySpan<System::Byte> buffer);
public virtual void Write (ReadOnlySpan<byte> buffer);
abstract member Write : ReadOnlySpan<byte> -> unit
override this.Write : ReadOnlySpan<byte> -> unit
Public Overridable Sub Write (buffer As ReadOnlySpan(Of Byte))

Parameters

buffer
ReadOnlySpan<Byte>

Ein Bereich im Arbeitsspeicher.A region of memory. Diese Methode kopiert den Inhalt dieses Bereichs in den aktuellen Datenstrom.This method copies the contents of this region to the current stream.

Remarks

Verwenden Sie die Eigenschaft CanWrite, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstützt.Use the CanWrite property to determine whether the current instance supports writing. Verwenden Sie die WriteAsync-Methode, um asynchron in den aktuellen Stream zu schreiben.Use the WriteAsync method to write asynchronously to the current stream.

Wenn der Schreibvorgang erfolgreich ist, wird die Position im Stream um die Anzahl der geschriebenen Bytes fortgesetzt.If the write operation is successful, the position within the stream advances by the number of bytes written. Wenn eine Ausnahme auftritt, bleibt die Position im Stream unverändert.If an exception occurs, the position within the stream remains unchanged.

Write(Byte[], Int32, Int32)

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Folge von Bytes in den aktuellen Stream und erhöht die aktuelle Position im Stream um die Anzahl der geschriebenen Bytes.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

public:
 abstract void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public abstract void Write (byte[] buffer, int offset, int count);
abstract member Write : byte[] * int * int -> unit
Public MustOverride Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parameters

buffer
Byte[]

Ein Array von Bytes.An array of bytes. Diese Methode kopiert count Bytes aus dem buffer in den aktuellen Stream.This method copies count bytes from buffer to the current stream.

offset
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

Die Anzahl der Byte, die in den aktuellen Datenstrom geschrieben wird.The number of bytes to be written to the current stream.

Exceptions

Die Summe von offset und count ist größer als die Pufferlänge.The sum of offset and count is greater than the buffer length.

buffer ist nullbuffer is null.

offset oder count ist ein negativer Wert.offset or count is negative.

Ein E/A-Fehler ist aufgetreten, z.B. „Die angegebene Datei kann nicht gefunden werden“.An I/O error occurred, such as the specified file cannot be found.

Der Stream unterstützt das Schreiben nicht.The stream does not support writing.

Write(Byte[], Int32, Int32) wurde aufgerufen, nachdem der Stream geschlossen wurde.Write(Byte[], Int32, Int32) was called after the stream was closed.

Remarks

Verwenden Sie die Eigenschaft CanWrite, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstützt.Use the CanWrite property to determine whether the current instance supports writing. Verwenden Sie die WriteAsync-Methode, um asynchron in den aktuellen Stream zu schreiben.Use the WriteAsync method to write asynchronously to the current stream.

Wenn der Schreibvorgang erfolgreich ist, wird die Position im Stream um die Anzahl der geschriebenen Bytes fortgesetzt.If the write operation is successful, the position within the stream advances by the number of bytes written. Wenn eine Ausnahme auftritt, bleibt die Position im Stream unverändert.If an exception occurs, the position within the stream remains unchanged.

See also

Applies to