¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

FileStream.WriteByte (Método)

Escribe un byte en la posición actual de la secuencia de archivo.

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

public override void WriteByte(
	byte value
)

Parámetros

value
Tipo: System.Byte
Un byte que se va a escribir en la secuencia.

ExcepciónCondición
ObjectDisposedException

La secuencia está cerrada.

NotSupportedException

La secuencia no es compatible con la escritura.

Este método invalida WriteByte.

Utilice WriteByte para escribir un byte en un FileStream de forma eficaz. Si la secuencia está cerrada o no se puede escribir en ella, se producirá una excepción.

NotaNota

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

Notas para los implementadores

La implementación predeterminada en Stream crea una nueva matriz de un solo byte y llama a Write. Si bien eso es formalmente correcto, no es muy eficaz. Cualquier secuencia que posea un búfer interno debe reemplazar este método y proporcionar una versión mucho más eficaz que lea el búfer directamente, evitando la asignación en memoria adicional de matrices en cada llamada.

Para obtener una lista de operaciones de archivo comunes y directorio, vea Tareas de E/S comunes.

En el ejemplo de código siguiente se muestra la forma de escribir datos en un archivo, byte a byte, y cómo se comprueba después que los datos se han escrito correctamente.


using System;
using System.IO;

class FStream
{
    static void Main()
    {
        const string fileName = "Test#@@#.dat";

        // Create random data to write to the file.
        byte[] dataArray = new byte[100000];
        new Random().NextBytes(dataArray);

        using(FileStream  
            fileStream = new FileStream(fileName, FileMode.Create))
        {
            // Write the data to the file, byte by byte.
            for(int i = 0; i < dataArray.Length; i++)
            {
                fileStream.WriteByte(dataArray[i]);
            }

            // Set the stream position to the beginning of the file.
            fileStream.Seek(0, SeekOrigin.Begin);

            // Read and verify the data.
            for(int i = 0; i < fileStream.Length; i++)
            {
                if(dataArray[i] != fileStream.ReadByte())
                {
                    Console.WriteLine("Error writing data.");
                    return;
                }
            }
            Console.WriteLine("The data was written to {0} " +
                "and verified.", fileStream.Name);
        }
    }
}


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft