Stream.Write Método

Definición

Sobrecargas

Write(ReadOnlySpan<Byte>)

Cuando se reemplaza en una clase derivada, se escribe una secuencia de bytes en la secuencia actual y se hace avanzar la posición actual dentro de la secuencia el número de bytes escritos.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)

Cuando se reemplaza en una clase derivada, se escribe una secuencia de bytes en la secuencia actual y se hace avanzar la posición actual dentro de la secuencia el número de bytes escritos.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>)

Cuando se reemplaza en una clase derivada, se escribe una secuencia de bytes en la secuencia actual y se hace avanzar la posición actual dentro de la secuencia el número de bytes escritos.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))

Parámetros

buffer
ReadOnlySpan<Byte>

Región de memoria.A region of memory. Este método copia el contenido de esta región en la secuencia actual.This method copies the contents of this region to the current stream.

Comentarios

Utilice la CanWrite propiedad para determinar si la instancia actual admite escritura.Use the CanWrite property to determine whether the current instance supports writing. Utilice el WriteAsync método para escribir de forma asincrónica en la secuencia actual.Use the WriteAsync method to write asynchronously to the current stream.

Si la operación de escritura se realiza correctamente, la posición dentro de la secuencia avanza por el número de bytes escritos.If the write operation is successful, the position within the stream advances by the number of bytes written. Si se produce una excepción, la posición dentro de la secuencia permanece sin cambios.If an exception occurs, the position within the stream remains unchanged.

Write(Byte[], Int32, Int32)

Cuando se reemplaza en una clase derivada, se escribe una secuencia de bytes en la secuencia actual y se hace avanzar la posición actual dentro de la secuencia el número de bytes escritos.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)

Parámetros

buffer
Byte[]

Matriz de bytes.An array of bytes. Este método copia count bytes desde buffer al flujo actual.This method copies count bytes from buffer to the current stream.

offset
Int32

Desplazamiento en bytes de base cero en la buffer en la que se comienzan a copiar los bytes en la secuencia actual.The zero-based byte offset in buffer at which to begin copying bytes to the current stream.

count
Int32

Número de bytes que se deben escribir en la secuencia actual.The number of bytes to be written to the current stream.

Excepciones

La suma de offset y count es mayor que la longitud del búfer.The sum of offset and count is greater than the buffer length.

buffer es null.buffer is null.

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

Se ha producido un error de E/S como: No se puede encontrar el archivo especificado.An I/O error occurred, such as the specified file cannot be found.

La secuencia no admite escritura.The stream does not support writing.

Se ha llamado a Write(Byte[], Int32, Int32) después de cerrar la secuencia.Write(Byte[], Int32, Int32) was called after the stream was closed.

Comentarios

Utilice la CanWrite propiedad para determinar si la instancia actual admite escritura.Use the CanWrite property to determine whether the current instance supports writing. Utilice el WriteAsync método para escribir de forma asincrónica en la secuencia actual.Use the WriteAsync method to write asynchronously to the current stream.

Si la operación de escritura se realiza correctamente, la posición dentro de la secuencia avanza por el número de bytes escritos.If the write operation is successful, the position within the stream advances by the number of bytes written. Si se produce una excepción, la posición dentro de la secuencia permanece sin cambios.If an exception occurs, the position within the stream remains unchanged.

Consulte también:

Se aplica a