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

Clase BinaryReader

 

Publicado: octubre de 2016

Lee primitivos tipos de datos como valores binarios en una codificación específica.

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

System.Object
  System.IO.BinaryReader

[ComVisibleAttribute(true)]
public class BinaryReader : IDisposable

NombreDescripción
System_CAPS_pubmethodBinaryReader(Stream)

Inicializa una nueva instancia de la clase BinaryReader basada en la secuencia especificada y usando codificación UTF-8.

System_CAPS_pubmethodBinaryReader(Stream, Encoding)

Inicializa una nueva instancia de la clase BinaryReader basada en la secuencia y codificación de caracteres especificadas.

System_CAPS_pubmethodBinaryReader(Stream, Encoding, Boolean)

Inicializa una nueva instancia de la clase BinaryReader basada en la secuencia y la codificación de caracteres especificadas y, opcionalmente, deja la secuencia abierta.

NombreDescripción
System_CAPS_pubpropertyBaseStream

Expone el acceso a la secuencia subyacente de BinaryReader.

NombreDescripción
System_CAPS_pubmethodClose()

Cierra el lector actual y la secuencia subyacente.

System_CAPS_pubmethodDispose()

Libera todos los recursos usados por la instancia actual de la clase BinaryReader.

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados usados que usa la clase BinaryReader y, de forma opcional, libera los recursos administrados.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFillBuffer(Int32)

Rellena el búfer interno con el número especificado de bytes leídos de la secuencia.

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodPeekChar()

Devuelve el siguiente carácter disponible y no hace avanzar la posición de bytes o caracteres.

System_CAPS_pubmethodRead()

Lee los caracteres de la secuencia subyacente y hace avanzar la posición actual de la secuencia de acuerdo con la Encoding usada y el carácter concreto que se lea de la secuencia.

System_CAPS_pubmethodRead(Byte[], Int32, Int32)

Lee el número especificado de bytes de la secuencia, a partir del punto especificado en la matriz de bytes.

System_CAPS_pubmethodRead(Char[], Int32, Int32)

Lee el número especificado de caracteres de la secuencia, a partir del punto especificado en la matriz de caracteres.

System_CAPS_protmethodRead7BitEncodedInt()

Lee un entero de 32 bits en formato comprimido.

System_CAPS_pubmethodReadBoolean()

Lee un valor Boolean de la secuencia actual y hace avanzar un byte la posición actual de la secuencia.

System_CAPS_pubmethodReadByte()

Lee el siguiente byte de la secuencia actual y hace avanzar un byte la posición actual de la secuencia.

System_CAPS_pubmethodReadBytes(Int32)

Lee el número especificado de bytes de la secuencia actual en una matriz de bytes y hace avanzar la posición actual en función del número de bytes leídos.

System_CAPS_pubmethodReadChar()

Lee el siguiente carácter de la secuencia actual y hace avanzar la posición actual de la secuencia de acuerdo con la Encoding usada y el carácter concreto que se lee de la secuencia.

System_CAPS_pubmethodReadChars(Int32)

Lee el número especificado de caracteres de la secuencia actual, devuelve los datos en una matriz de caracteres y hace avanzar la posición actual de acuerdo con la Encoding usada y el carácter concreto que se lee en la secuencia.

System_CAPS_pubmethodReadDecimal()

Lee un valor decimal de la secuencia actual y hace avanzar la posición actual de la secuencia dieciséis bytes.

System_CAPS_pubmethodReadDouble()

Lee un valor de punto flotante de 8 bytes de la secuencia actual y hace avanzar la posición actual de la secuencia en ocho bytes.

System_CAPS_pubmethodReadInt16()

Lee un entero con signo de 2 bytes en la secuencia actual y hace avanzar la posición actual de la secuencia en dos bytes.

System_CAPS_pubmethodReadInt32()

Lee un entero con signo de 4 bytes en la secuencia actual y hace avanzar la posición actual de la secuencia en cuatro bytes.

System_CAPS_pubmethodReadInt64()

Lee un entero con signo de 8 bytes de la secuencia actual y avanza la posición actual de la secuencia en ocho bytes.

System_CAPS_pubmethodReadSByte()

Lee un byte con signo de esta secuencia y hace avanzar la posición actual de la secuencia en un byte.

System_CAPS_pubmethodReadSingle()

Lee un valor de punto flotante de 4 bytes en la secuencia actual y hace avanzar la posición actual de la secuencia en cuatro bytes.

System_CAPS_pubmethodReadString()

Lee una cadena de la secuencia actual. La cadena tiene como prefijo la longitud, codificada como un entero de siete bits cada vez.

System_CAPS_pubmethodReadUInt16()

Lee un entero sin signo de 2 bytes de la secuencia actual con la codificación "little-endian" y hace avanzar la posición de la secuencia en dos bytes.

System_CAPS_pubmethodReadUInt32()

Lee un entero sin signo de 4 bytes de la secuencia actual y hace avanzar la posición de la secuencia en cuatro bytes.

System_CAPS_pubmethodReadUInt64()

Lee un entero sin signo de 8 bytes de la secuencia actual y hace avanzar la posición de la secuencia en ocho bytes.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

La BinaryReader clase proporciona métodos que simplifican la lectura de tipos de datos primitivos de una secuencia. Por ejemplo, puede usar el ReadBoolean método para leer el siguiente byte como un valor booleano y hace avanzar un byte la posición actual en la secuencia. La clase incluye métodos de lectura que admiten diferentes tipos de datos.

Cuando se crea una nueva instancia de la BinaryReader (clase), proporciona la secuencia para leer de y, opcionalmente, especifique el tipo de codificación y si se deja la secuencia abierto después de desechar el BinaryReader objeto. Si no especifica un tipo de codificación, se utiliza UTF-8.

System_CAPS_importantImportante

Este tipo implementa la IDisposable interfaz. Cuando haya terminado de utilizar el tipo, debería eliminar, directa o indirectamente. Para deshacerse del tipo directamente, llame a su Dispose método en un try/catch bloque. Para deshacerse de él indirectamente, usar una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, consulte la sección "Uso de un objeto que implementa IDisposable" en el IDisposable tema de la interfaz.

En el ejemplo de código siguiente se muestra cómo almacenar y recuperar la configuración de la aplicación en un archivo.

using System;
using System.IO;

class ConsoleApplication
{
    const string fileName = "AppSettings.dat";

    static void Main()
    {
        WriteDefaultValues();
        DisplayValues();
    }

    public static void WriteDefaultValues()
    {
        using (BinaryWriter writer = new BinaryWriter(File.Open(fileName, FileMode.Create)))
        {
            writer.Write(1.250F);
            writer.Write(@"c:\Temp");
            writer.Write(10);
            writer.Write(true);
        }
    }

    public static void DisplayValues()
    {
        float aspectRatio;
        string tempDirectory;
        int autoSaveTime;
        bool showStatusBar;

        if (File.Exists(fileName))
        {
            using (BinaryReader reader = new BinaryReader(File.Open(fileName, FileMode.Open)))
            {
                aspectRatio = reader.ReadSingle();
                tempDirectory = reader.ReadString();
                autoSaveTime = reader.ReadInt32();
                showStatusBar = reader.ReadBoolean();
            }

            Console.WriteLine("Aspect ratio set to: " + aspectRatio);
            Console.WriteLine("Temp directory is: " + tempDirectory);
            Console.WriteLine("Auto save time set to: " + autoSaveTime);
            Console.WriteLine("Show status bar: " + showStatusBar);
        }
    }
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: