BinaryWriter Třída

Definice

Obor názvů:
System.IO
Sestavení:
mscorlib.dll, System.IO.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
System.IO.dll
Sestavení:
System.Runtime.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
BinaryWriter.cs
Zdroj:
BinaryWriter.cs
Zdroj:
BinaryWriter.cs
Zdroj:
BinaryWriter.cs
Zdroj:
BinaryWriter.cs

Zapisuje primitivní typy do datového proudu a podporuje zápis řetězců v určitém kódování.

public ref class BinaryWriter : IDisposable
public ref class BinaryWriter : IAsyncDisposable, IDisposable
public class BinaryWriter : IDisposable
public class BinaryWriter : IAsyncDisposable, IDisposable
[System.Serializable]
public class BinaryWriter : IDisposable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class BinaryWriter : IDisposable
type BinaryWriter = class
    interface IDisposable
type BinaryWriter = class
    interface IAsyncDisposable
    interface IDisposable
[<System.Serializable>]
type BinaryWriter = class
    interface IDisposable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type BinaryWriter = class
    interface IDisposable
Public Class BinaryWriter
Implements IDisposable
Public Class BinaryWriter
Implements IAsyncDisposable, IDisposable
Dědičnost
Object
BinaryWriter
Atributy
SerializableAttribute ComVisibleAttribute
Implementuje
IDisposable IAsyncDisposable

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 BinaryWriter poskytuje metody, které zjednodušují zápis primitivních datových typů do datového proudu. Pomocí metody můžete Write například napsat logickou hodnotu do datového proudu jako hodnotu 1 bajtu. Třída obsahuje metody zápisu, které podporují různé datové typy.

Když vytvoříte novou instanci BinaryWriter třídy, poskytnete datový proud pro zápis a volitelně zadáte typ kódování a zda chcete datový proud nechat otevřený po vystavení objektu BinaryWriter . Pokud nezadáte typ kódování, použije se UTF-8.

Important

Tento typ implementuje rozhraní IDisposable. Až tento typ dokončíte, měli byste ho odstranit buď přímo (zavoláním metody Dispose ), nebo nepřímo (s konstruktorem jazyka, například using v jazyce C#). Další informace naleznete v tématu Použití objektu, který implementuje IDisposable.

Odvozená třída může přepsat metody této třídy, aby poskytovaly jedinečné kódování znaků.

Konstruktory

Name Description
BinaryWriter()

Inicializuje novou instanci BinaryWriter třídy, která zapisuje do datového proudu.
BinaryWriter(Stream, Encoding, Boolean)

Inicializuje novou instanci třídy na základě zadaného kódování datových BinaryWriter proudů a znaků a volitelně ponechá stream otevřený.
BinaryWriter(Stream, Encoding)

Inicializuje novou instanci BinaryWriter třídy na základě zadaného streamu a kódování znaků.
BinaryWriter(Stream)

Inicializuje novou instanci třídy na základě zadaného datového BinaryWriter proudu a pomocí kódování UTF-8.

Pole

Name Description
Null

Určuje bez záložního BinaryWriter úložiště.
OutStream

Obsahuje podkladový datový proud.

Vlastnosti

Name Description
BaseStream

Získá základní proud BinaryWriter.

Metody

Name Description
Close()

Zavře aktuální BinaryWriter a podkladový datový proud.
Dispose()

Uvolní všechny prostředky používané aktuální instancí BinaryWriter třídy.
Dispose(Boolean)

Uvolní nespravované prostředky používané BinaryWriter a volitelně uvolní spravované prostředky.
DisposeAsync()

Asynchronně uvolní všechny prostředky používané aktuální instancí BinaryWriter třídy.
Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
Flush()

Vymaže všechny vyrovnávací paměti pro aktuální zapisovač a způsobí zápis všech dat uložených do vyrovnávací paměti do podkladového zařízení.
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
Seek(Int32, SeekOrigin)

Nastaví pozici v aktuálním datovém proudu.
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
Write(Boolean)

Zapíše hodnotu 1 bajtu Boolean do aktuálního datového proudu s hodnotou 0 představující false a 1 představující true.
Write(Byte)

Zapíše nepodepsaný bajt do aktuálního datového proudu a posune pozici datového proudu o jeden bajt.
Write(Byte[], Int32, Int32)

Zapíše oblast pole bajtů do aktuálního datového proudu.
Write(Byte[])

Zapíše bajtové pole do podkladového datového proudu.
Write(Char)

Zapíše znak Unicode do aktuálního datového proudu a posune aktuální pozici datového proudu v souladu s použitými Encoding a konkrétními znaky, které se zapisují do datového proudu.
Write(Char[], Int32, Int32)

Zapíše část pole znaků do aktuálního datového proudu a posune aktuální pozici datového proudu v souladu s použitými Encoding a možná konkrétními znaky, které se zapisují do datového proudu.
Write(Char[])

Zapíše pole znaků do aktuálního datového proudu a posune aktuální pozici datového proudu v souladu s použitými Encoding a konkrétními znaky, které se zapisují do datového proudu.
Write(Decimal)

Zapíše desetinnou hodnotu do aktuálního datového proudu a posune pozici datového proudu o šestnáct bajtů.
Write(Double)

Zapíše osmibajtů hodnotu s plovoucí desetinou čárkou do aktuálního datového proudu a posune pozici datového proudu o osm bajtů.
Write(Half)

Zapíše dvoubajtů hodnotu s plovoucí desetinou čárkou do aktuálního datového proudu a posune pozici datového proudu o dva bajty.
Write(Int16)

Zapíše do aktuálního datového proudu dvoubajtů celé číslo se dvěma bajty a posune pozici datového proudu o dva bajty.
Write(Int32)

Zapíše do aktuálního datového proudu celé číslo se 4 bajty a posune pozici datového proudu o čtyři bajty.
Write(Int64)

Zapíše do aktuálního datového proudu celé číslo s osmi bajty a posune pozici datového proudu o osm bajtů.
Write(ReadOnlySpan<Byte>)

Zapíše rozsah bajtů do aktuálního datového proudu.
Write(ReadOnlySpan<Char>)

Zapíše rozsah znaků do aktuálního datového proudu a posune aktuální pozici datového proudu v souladu s použitými Encoding a možná konkrétními znaky, které se zapisují do datového proudu.
Write(SByte)

Zapíše podepsaný bajt do aktuálního datového proudu a posune pozici datového proudu o jeden bajt.
Write(Single)

Zapíše čtyřbajtů hodnotu s plovoucí desetinou čárkou do aktuálního datového proudu a posune pozici datového proudu o čtyři bajty.
Write(String)

Zapíše řetězec s předponou délky do tohoto datového BinaryWriterproudu v aktuálním kódování a posune aktuální pozici datového proudu v souladu s použitým kódováním a konkrétní znaky, které se zapisují do datového proudu.
Write(UInt16)

Zapíše dvoubajtů celé číslo bez znaménka do aktuálního datového proudu a posune pozici datového proudu o dva bajty.
Write(UInt32)

Zapíše 4bajtů bez znaménka do aktuálního datového proudu a posune pozici datového proudu o čtyři bajty.
Write(UInt64)

Zapíše 8bajtů bez znaménka do aktuálního datového proudu a posune pozici datového proudu o osm bajtů.
Write7BitEncodedInt(Int32)

Zapíše 32bitové celé číslo v komprimovaném formátu.
Write7BitEncodedInt64(Int64)

Zapíše najednou číslo 7 bitů.

Explicitní implementace rozhraní

Name Description
IDisposable.Dispose()

Uvolní nespravované prostředky používané BinaryWriter a volitelně uvolní spravované prostředky.

Metody rozšíření

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Platí pro

Viz také