BinaryReader Třída

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

BinaryReader.cs

Čte primitivní datové typy jako binární hodnoty v konkrétním kódování.

public ref class BinaryReader : IDisposable

public class BinaryReader : IDisposable

type BinaryReader = class
    interface IDisposable

Public Class BinaryReader
Implements IDisposable

Dědičnost

Object

BinaryReader

Implementuje

IDisposable

Příklady

Následující příklad kódu ukazuje, jak uložit a načíst nastavení aplikace v souboru.

using System;
using System.IO;
using System.Text;

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

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

    public static void WriteDefaultValues()
    {
        using (var stream = File.Open(fileName, FileMode.Create))
        {
            using (var writer = new BinaryWriter(stream, Encoding.UTF8, false))
            {
                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 (var stream = File.Open(fileName, FileMode.Open))
            {
                using (var reader = new BinaryReader(stream, Encoding.UTF8, false))
                {
                    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);
        }
    }
}

open System.IO
open System.Text

let fileName = "AppSettings.dat"

let writeDefaultValues () =
    use stream = File.Open(fileName, FileMode.Create)
    use writer = new BinaryWriter(stream, Encoding.UTF8, false)
    writer.Write 1.250F
    writer.Write @"c:\Temp"
    writer.Write 10
    writer.Write true

let displayValues () =
    if File.Exists fileName then
        use stream = File.Open(fileName, FileMode.Open)
        use reader = new BinaryReader(stream, Encoding.UTF8, false)
        let aspectRatio = reader.ReadSingle()
        let tempDirectory = reader.ReadString()
        let autoSaveTime = reader.ReadInt32()
        let showStatusBar = reader.ReadBoolean()

        printfn $"Aspect ratio set to: {aspectRatio}"
        printfn $"Temp directory is: {tempDirectory}"
        printfn $"Auto save time set to: {autoSaveTime}"
        printfn $"Show status bar: {showStatusBar}"

writeDefaultValues ()
displayValues ()

Imports System.IO

Module Module1
    Const fileName As String = "AppSettings.dat"

    Sub Main()
        WriteDefaultValues()
        DisplayValues()
    End Sub

    Sub WriteDefaultValues()
        Using writer As BinaryWriter = New BinaryWriter(File.Open(fileName, FileMode.Create))
            writer.Write(1.25F)
            writer.Write("c:\Temp")
            writer.Write(10)
            writer.Write(True)
        End Using
    End Sub

    Sub DisplayValues()
        Dim aspectRatio As Single
        Dim tempDirectory As String
        Dim autoSaveTime As Integer
        Dim showStatusBar As Boolean

        If (File.Exists(fileName)) Then

            Using reader As BinaryReader = New BinaryReader(File.Open(fileName, FileMode.Open))
                aspectRatio = reader.ReadSingle()
                tempDirectory = reader.ReadString()
                autoSaveTime = reader.ReadInt32()
                showStatusBar = reader.ReadBoolean()
            End Using

            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)
        End If
    End Sub

End Module

Poznámky

Třída BinaryReader poskytuje metody, které zjednodušují čtení primitivních datových typů ze streamu. Pomocí metody můžete ReadBoolean například přečíst další bajt jako logickou hodnotu a posunout aktuální pozici v datovém proudu o jeden bajt. Třída zahrnuje metody čtení, které podporují různé datové typy.

Když vytvoříte novou instanci BinaryReader třídy, zadáte datový proud, ze který se má číst, a volitelně určíte typ kódování a zda se má datový proud nechat otevřený po odstranění objektu BinaryReader . Pokud nezadáte typ kódování, použije se UTF-8.

Důležité

Tento typ implementuje IDisposable rozhraní. Po dokončení používání tohoto typu byste ho měli přímo nebo nepřímo odstranit. Pokud chcete odstranit typ přímo, zavolejte jeho Dispose metodu try/catch v bloku. Pokud ho chcete odstranit nepřímo, použijte konstruktor jazyka, například using (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace najdete v části "Použití objektu, který implementuje IDisposable" v IDisposable tématu rozhraní.

Konstruktory

BinaryReader(Stream)	Inicializuje novou instanci BinaryReader třídy na základě zadaného datového proudu a pomocí kódování UTF-8.
BinaryReader(Stream, Encoding)	Inicializuje novou instanci BinaryReader třídy na základě zadaného datového proudu a kódování znaků.
BinaryReader(Stream, Encoding, Boolean)	Inicializuje novou instanci třídy na základě zadaného datového BinaryReader proudu a kódování znaků a volitelně ponechá datový proud otevřený.

Vlastnosti

BaseStream

Zpřístupňuje přístup k podkladovému datovému proudu objektu BinaryReader.

Metody

Close()	Zavře aktuálního čtenáře a podkladový datový proud.
Dispose()	Uvolní všechny prostředky používané aktuální instancí BinaryReader třídy.
Dispose(Boolean)	Uvolní nespravované prostředky používané BinaryReader třídou a volitelně uvolní spravované prostředky.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FillBuffer(Int32)	Vyplní vnitřní vyrovnávací paměť zadaným počtem bajtů načtených z datového proudu.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
PeekChar()	Vrátí další dostupný znak a neposoudí bajt ani pozici znaku.
Read()	Přečte znaky z podkladového datového proudu a posune aktuální pozici datového proudu v souladu s použitým Encoding a konkrétním znakem, který se z datového proudu čte.
Read(Byte[], Int32, Int32)	Přečte zadaný počet bajtů z datového proudu, počínaje zadaným bodem v bajtovém poli.
Read(Char[], Int32, Int32)	Přečte zadaný počet znaků z datového proudu, počínaje zadaným bodem v poli znaků.
Read(Span<Byte>)	Přečte posloupnost bajtů z aktuálního datového proudu a posune pozici v rámci streamu o počet přečtených bajtů.
Read(Span<Char>)	Přečte z aktuálního datového proudu stejný počet znaků jako délka poskytnuté vyrovnávací paměti, zapíše je do poskytnuté vyrovnávací paměti a posune aktuální pozici podle použitého Encoding a konkrétního znaku, který se z datového proudu čte.
Read7BitEncodedInt()	Čte v 32bitovém celočíselném formátu v komprimovaném formátu.
Read7BitEncodedInt64()	Přečte číslo 7 bitů najednou.
ReadBoolean()	Načte Boolean hodnotu z aktuálního datového proudu a posune aktuální pozici datového proudu o jeden bajt.
ReadByte()	Přečte další bajt z aktuálního datového proudu a posune aktuální pozici streamu o jeden bajt.
ReadBytes(Int32)	Přečte zadaný počet bajtů z aktuálního datového proudu do pole bajtů a posune aktuální pozici o tento počet bajtů.
ReadChar()	Přečte další znak z aktuálního datového proudu a posune aktuální pozici datového proudu v souladu s použitým Encoding a konkrétním znakem, který se z datového proudu čte.
ReadChars(Int32)	Přečte zadaný počet znaků z aktuálního datového proudu, vrátí data v poli znaků a posune aktuální pozici v souladu s použitým Encoding a konkrétním znakem, který se čte z datového proudu.
ReadDecimal()	Načte desetinnou hodnotu z aktuálního datového proudu a posune aktuální pozici datového proudu o šestnáct bajtů.
ReadDouble()	Načte hodnotu s plovoucí desetinou čárkou o 8 bajtů z aktuálního datového proudu a posune aktuální pozici datového proudu o osm bajtů.
ReadHalf()	Načte hodnotu s plovoucí desetinou čárkou o 2 bajty z aktuálního datového proudu a posune aktuální pozici datového proudu o dva bajty.
ReadInt16()	Načte celé číslo se 2 bajty z aktuálního datového proudu a posune aktuální pozici datového proudu o dva bajty.
ReadInt32()	Přečte celé číslo se 4 bajty z aktuálního datového proudu a posune aktuální pozici datového proudu o čtyři bajty.
ReadInt64()	Načte celé číslo se 8 bajty z aktuálního datového proudu a posune aktuální pozici datového proudu o osm bajtů.
ReadSByte()	Přečte podepsaný bajt z tohoto datového proudu a posune aktuální pozici streamu o jeden bajt.
ReadSingle()	Načte hodnotu s plovoucí desetinou čárkou o 4 bajty z aktuálního datového proudu a posune aktuální pozici datového proudu o čtyři bajty.
ReadString()	Přečte řetězec z aktuálního datového proudu. Řetězec má předponu s délkou, zakódovanou jako celé číslo sedm bitů najednou.
ReadUInt16()	Načte 2 bajtové celé číslo bez znaménka z aktuálního datového proudu pomocí kódování little-endian a posune pozici datového proudu o dva bajty.
ReadUInt32()	Přečte 4 bajtové celé číslo bez znaménka z aktuálního datového proudu a posune pozici datového proudu o čtyři bajty.
ReadUInt64()	Přečte celé číslo bez znaménka o 8 bajtů z aktuálního datového proudu a posune pozici datového proudu o osm bajtů.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Postupy: Čtení a zápis do nově vytvořeného datového souboru
• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru