Stream.Write Stream.Write Stream.Write Stream.Write Method

Definition

Überlädt

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) 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) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) 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>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) 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))

Parameter

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.

Hinweise

Verwenden Sie CanWrite die-Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstütztUse the CanWrite property to determine whether the current instance supports writing. Verwenden Sie WriteAsync die-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) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) 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)

Parameter

buffer
Byte[]

Ein Bytearray.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 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 Anzahl an Bytes, die in den aktuellen Stream geschrieben werden sollen.The number of bytes to be written to the current stream.

Ausnahmen

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.

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.

Hinweise

Verwenden Sie CanWrite die-Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstütztUse the CanWrite property to determine whether the current instance supports writing. Verwenden Sie WriteAsync die-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.

Siehe auch

Gilt für: