Stream.Write Stream.Write Stream.Write Stream.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 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>)

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>

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 der CanWrite Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstützt.Use the CanWrite property to determine whether the current instance supports writing. Verwenden der WriteAsync Methode asynchron in den aktuellen Stream geschrieben.Use the WriteAsync method to write asynchronously to the current stream.

Wenn der Schreibvorgang erfolgreich ist, setzt sich die Position im Stream um die Anzahl der geschriebenen Bytes.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: