Sdílet prostřednictvím

BinaryWriter Třída

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
System.IO.dll
Sestavení:
System.Runtime.dll
Sestavení:
System.Runtime.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
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 Write můžete 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 třídy BinaryWriter, zadáte datový proud pro zápis a volitelně zadáte typ kódování a zda se má datový proud nechat otevřený po odstranění objektu BinaryWriter. Pokud nezadáte typ kódování, použije se UTF-8.

Důležitý

Tento typ implementuje rozhraní IDisposable. Jakmile typ dokončíte, měli byste ho odstranit buď přímo, nebo nepřímo. Chcete-li typ odstranit přímo, zavolejte jeho Dispose metodu v bloku try/catch. Pokud ho chcete zlikvidovat nepřímo, použijte konstruktor jazyka, jako je using (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace naleznete v části Použití objektu, který implementuje IDisposable v tématu IDisposable rozhraní.

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

Konstruktory

BinaryWriter()

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

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

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

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

Pole

Null

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

Obsahuje podkladový datový proud.

Vlastnosti

BaseStream

Získá základní proud BinaryWriter.

Metody

Close()

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

Uvolní všechny prostředky používané aktuální instancí třídy BinaryWriter.
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í třídy BinaryWriter.
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 Boolean 1 bajtu do aktuálního datového proudu, přičemž 0 představuje 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[])

Zapíše bajtové pole do podkladového datového proudu.
Write(Byte[], Int32, Int32)

Zapíše oblast pole bajtů do aktuální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 Encoding použitými a 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 Encoding použitými 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 Encoding použitými a možná 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 Encoding použitými 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 streamu v aktuálním kódování BinaryWritera posune aktuální pozici datového proudu v souladu s použitým kódováním a konkrétními 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í

IDisposable.Dispose()

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

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

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

Platí pro

Viz také