Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método FileStream.Write (Byte[], Int32, Int32)

 

Publicado: octubre de 2016

Escribe un bloque de bytes en la secuencia de archivo.

Espacio de nombres:   System.IO
Ensamblado:  mscorlib (en mscorlib.dll)

public override void Write(
	byte[] array,
	int offset,
	int count
)

Parámetros

array
Type: System.Byte[]

Búfer que contiene los datos que se van a escribir en la secuencia.

offset
Type: System.Int32

Desplazamiento en bytes de base cero de array desde donde se comienzan a copiar los bytes en la secuencia.

count
Type: System.Int32

Número máximo de bytes que se pueden escribir.

Exception Condition
ArgumentNullException

El valor de array es null.

ArgumentException

offset y count describen un intervalo no válido en array.

ArgumentOutOfRangeException

offset o count es negativo.

IOException

Error de E/S.

o bien

Otro subproceso puede haber producido un cambio inesperado en la posición del identificador de archivo del sistema operativo.

ObjectDisposedException

La secuencia está cerrada.

NotSupportedException

La instancia actual de la secuencia no admite la escritura.

Este método invalida Write.

El offset parámetro indica el desplazamiento del byte en array (el índice de búfer) en el que se comienzan a copiar y el count parámetro proporciona el número de bytes que se escribirán en la secuencia. Si la operación de escritura se realiza correctamente, la posición actual de la secuencia avanza por el número de bytes escritos. Si se produce una excepción, no se modifica la posición actual de la secuencia.

System_CAPS_noteNota

Use la CanWrite propiedad para determinar si la instancia actual admite escritura. Para obtener información adicional, vea CanWrite.

No se interrumpirá un subproceso que está realizando una operación de escritura. Aunque puede parecer que la aplicación para que se ejecute correctamente después de que el subproceso se desbloquea, la interrupción puede disminuir el rendimiento y la confiabilidad de la aplicación.

Para obtener una lista de operaciones de directorio y archivo común, consulte Tareas de E/S comunes.

Este ejemplo de código forma parte de un ejemplo mayor proporcionado para el Lock método.

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

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar: