FileStream.Write FileStream.Write FileStream.Write FileStream.Write Method

Definición

Sobrecargas

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)

Escribe una secuencia de bytes en un intervalo de solo lectura en la secuencia de archivo actual y avanza la posición actual en esta secuencia de archivo según el número de bytes escritos.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Escribe un bloque de bytes en la secuencia de archivo.Writes a block of bytes to the file stream.

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)

Escribe una secuencia de bytes en un intervalo de solo lectura en la secuencia de archivo actual y avanza la posición actual en esta secuencia de archivo según el número de bytes escritos.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);
public override void Write (ReadOnlySpan<byte> buffer);
override this.Write : ReadOnlySpan<byte> -> unit
Public Overrides 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 de archivo actual.This method copies the contents of this region to the current file 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 del flujo de archivos avanza por el número de bytes escritos.If the write operation is successful, the position within the file stream advances by the number of bytes written. Si se produce una excepción, la posición dentro del flujo de archivo permanece sin cambios.If an exception occurs, the position within the file stream remains unchanged.

Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Escribe un bloque de bytes en la secuencia de archivo.Writes a block of bytes to the file stream.

public:
 override void Write(cli::array <System::Byte> ^ array, int offset, int count);
public override void Write (byte[] array, int offset, int count);
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (array As Byte(), offset As Integer, count As Integer)

Parámetros

array
Byte[]

Búfer que contiene los datos que se van a escribir en la secuencia.The buffer containing data to write to the stream.

offset
Int32 Int32 Int32 Int32

Desplazamiento en bytes de base cero de array desde donde se comienzan a copiar los bytes en la secuencia.The zero-based byte offset in array from which to begin copying bytes to the stream.

count
Int32 Int32 Int32 Int32

Número máximo de bytes que se pueden escribir.The maximum number of bytes to write.

Excepciones

offset y count describen un intervalo no válido en array.offset and count describe an invalid range in array.

Error de E/S.An I/O error occurred.

o bien-or-

Otro subproceso puede haber producido un cambio inesperado en la posición del identificador de archivo del sistema operativo.Another thread may have caused an unexpected change in the position of the operating system's file handle.

La instancia actual de la secuencia no admite la escritura.The current stream instance does not support writing.

Ejemplos

Este ejemplo de código forma parte de un ejemplo mayor proporcionado para Lock el método.This code example is part of a larger example provided for the Lock method.

// Write the original file data.
if ( fileStream->Length == 0 )
{
   tempString = String::Concat( lastRecordText, recordNumber.ToString() );
   fileStream->Write( uniEncoding->GetBytes( tempString ), 0, uniEncoding->GetByteCount( tempString ) );
}

// Write the original file data.
if(fileStream.Length == 0)
{
    tempString = 
        lastRecordText + recordNumber.ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString), 
        0, uniEncoding.GetByteCount(tempString));
}
' Write the original file data.
If aFileStream.Length = 0 Then
    tempString = _
        lastRecordText + recordNumber.ToString()
    aFileStream.Write(uniEncoding.GetBytes(tempString), _
        0, uniEncoding.GetByteCount(tempString))
End If

Comentarios

Este método invalida Write.This method overrides Write.

El offset parámetro proporciona el desplazamiento del byte en array (el índice de búfer) en el que se va a empezar a count copiar y el parámetro proporciona el número de bytes que se escribirán en la secuencia.The offset parameter gives the offset of the byte in array (the buffer index) at which to begin copying, and the count parameter gives the number of bytes that will be written to the stream. Si la operación de escritura se realiza correctamente, la posición actual de la secuencia se avanza por el número de bytes escritos.If the write operation is successful, the current position of the stream is advanced by the number of bytes written. Si se produce una excepción, la posición actual de la secuencia no cambia.If an exception occurs, the current position of the stream is unchanged.

Nota

Utilice la CanWrite propiedad para determinar si la instancia actual admite escritura.Use the CanWrite property to determine whether the current instance supports writing. Para obtener información adicional, vea CanWrite.For additional information, see CanWrite.

No interrumpa un subproceso que está realizando una operación de escritura.Do not interrupt a thread that is performing a write operation. Aunque puede parecer que la aplicación se ejecuta correctamente después de desbloquear el subproceso, la interrupción puede reducir el rendimiento y la confiabilidad de la aplicación.Although the application may appear to run successfully after the thread is unblocked, the interruption can decrease your application's performance and reliability.

Para obtener una lista de operaciones comunes de archivos y directorios, vea tareas de e/s comunes.For a list of common file and directory operations, see Common I/O Tasks.

Consulte también:

Se aplica a