Stream.Write Metodo

Definizione

Overload

Write(ReadOnlySpan<Byte>)

Quando ne viene eseguito l'override in una classe derivata, scrive una sequenza di byte nel flusso corrente e passa alla posizione successiva all'interno del flusso corrente in base al numero di byte scritti.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)

Quando ne viene eseguito l'override in una classe derivata, scrive una sequenza di byte nel flusso corrente e passa alla posizione successiva all'interno del flusso corrente in base al numero di byte scritti.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>)

Quando ne viene eseguito l'override in una classe derivata, scrive una sequenza di byte nel flusso corrente e passa alla posizione successiva all'interno del flusso corrente in base al numero di byte scritti.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))

Parametri

buffer
ReadOnlySpan<Byte>

Un'area di memoria.A region of memory. Questo metodo copia il contenuto di questa area nel flusso corrente.This method copies the contents of this region to the current stream.

Commenti

Utilizzare la CanWrite proprietà per determinare se l'istanza corrente supporta la scrittura.Use the CanWrite property to determine whether the current instance supports writing. Usare il WriteAsync metodo per scrivere in modo asincrono nel flusso corrente.Use the WriteAsync method to write asynchronously to the current stream.

Se l'operazione di scrittura ha esito positivo, la posizione all'interno del flusso avanza per il numero di byte scritti.If the write operation is successful, the position within the stream advances by the number of bytes written. Se si verifica un'eccezione, la posizione all'interno del flusso rimane invariata.If an exception occurs, the position within the stream remains unchanged.

Si applica a

Write(Byte[], Int32, Int32)

Quando ne viene eseguito l'override in una classe derivata, scrive una sequenza di byte nel flusso corrente e passa alla posizione successiva all'interno del flusso corrente in base al numero di byte scritti.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)

Parametri

buffer
Byte[]

Matrice di byte.An array of bytes. Questo metodo copia i byte count da buffer nel flusso corrente.This method copies count bytes from buffer to the current stream.

offset
Int32

Offset dei byte in base zero in buffer da cui iniziare la copia dei byte nel flusso corrente.The zero-based byte offset in buffer at which to begin copying bytes to the current stream.

count
Int32

Numero di byte da scrivere nel flusso corrente.The number of bytes to be written to the current stream.

Eccezioni

La somma di offset e count è maggiore della lunghezza del buffer.The sum of offset and count is greater than the buffer length.

buffer è null.buffer is null.

offset o count è negativo.offset or count is negative.

Si è verificato un errore di I/O, ad esempio non è possibile trovare il file specificato.An I/O error occurred, such as the specified file cannot be found.

Il flusso non supporta la scrittura.The stream does not support writing.

Write(Byte[], Int32, Int32) è stato chiamato dopo la chiusura del flusso.Write(Byte[], Int32, Int32) was called after the stream was closed.

Commenti

Utilizzare la CanWrite proprietà per determinare se l'istanza corrente supporta la scrittura.Use the CanWrite property to determine whether the current instance supports writing. Usare il WriteAsync metodo per scrivere in modo asincrono nel flusso corrente.Use the WriteAsync method to write asynchronously to the current stream.

Se l'operazione di scrittura ha esito positivo, la posizione all'interno del flusso avanza per il numero di byte scritti.If the write operation is successful, the position within the stream advances by the number of bytes written. Se si verifica un'eccezione, la posizione all'interno del flusso rimane invariata.If an exception occurs, the position within the stream remains unchanged.

Vedi anche

Si applica a