Este tema aún no ha recibido ninguna valoración - Valorar este tema

FileStream.Write (Método)

.NET Framework 2.0

Otras versiones

Escribe un bloque de bytes en esta secuencia mediante el uso de datos de un búfer.

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

Sintaxis

C++

Copiar

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

Copiar

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

JScript

Copiar

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

Parámetros

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

offset: Desplazamiento en bytes de base cero de arraydonde se comienzan a copiar los datos en la secuencia actual.

count: Número máximo de bytes que se deben escribir en la secuencia actual.

Excepciones

Tipo de excepción	Condición
ArgumentNullException	array es referencia de objeto null (Nothing en Visual Basic).
ArgumentException	offset y count describen un intervalo no válido en array.
ArgumentOutOfRangeException	El valor de offset o count es negativo.
IOException	Se produce un error de E/S. O bien Otro subproceso puede haber producido un cambio inesperado en la posición del identificador de archivos del sistema operativo.
ObjectDisposedException	La secuencia está cerrada.
NotSupportedException	La instancia de la secuencia actual no admite escritura.

Comentarios

Este método reemplaza a Write.

El parámetro offset indica el desplazamiento del byte de array (índice de búfer) donde debe iniciarse la copia, y el parámetro count proporciona el número máximo de bytes que se van a escribir en la secuencia. Si la operación de escritura se ha realizado correctamente, la posición actual de la secuencia avanza según el número de bytes escritos. Si se produce una excepción, la posición actual de la secuencia no experimentará ningún cambio.

Nota
Se utiliza la propiedad CanWrite para determinar si la instancia actual admite operaciones de escritura. Para obtener más información, vea CanWrite.

En la siguiente tabla se muestran ejemplos de otras tareas de E/S típicas o relacionadas.

Para realizar esta operación...	Vea el ejemplo de este tema...
Crear un archivo de texto	Cómo: Escribir texto en un archivo
Escribir en un archivo de texto	Cómo: Escribir texto en un archivo
Leer de un archivo de texto	Cómo: Leer texto de un archivo
Anexar texto a un archivo	Cómo: Abrir y anexar a un archivo de registro File.AppendText FileInfo.AppendText
Cambiar de nombre o mover un archivo	File.Move FileInfo.MoveTo
Copiar un archivo	File.Copy FileInfo.CopyTo
Obtener el tamaño de un archivo	FileInfo.Length
Obtener los atributos de un archivo	File.GetAttributes
Establecer los atributos de un archivo	File.SetAttributes
Determinar si un archivo existe	File.Exists
Leer de un archivo binario	Cómo: Leer y escribir en un archivo de datos recién creado
Escribir en un archivo binario	Cómo: Leer y escribir en un archivo de datos recién creado
Crear un directorio	Directory.CreateDirectory Directory.CreateDirectory

Ejemplo

Este ejemplo de código forma parte de un ejemplo más extenso referente a la clase Lock.

C++

Copiar

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

Copiar

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

Plataformas

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

Información de versión