BinaryReader 建構函式

定義

命名空間:

System.IO

組件:

System.Runtime.dll

初始化 BinaryReader 類別的新執行個體。

多載

BinaryReader(Stream)	根據指定的資料流並使用 UTF-8 編碼方式，初始化 BinaryReader 類別的新執行個體。
BinaryReader(Stream, Encoding)	根據指定的資料流和字元編碼，初始化 BinaryReader 類別的新執行個體。
BinaryReader(Stream, Encoding, Boolean)	根據指定的資料流和特定的字元編碼，初始化 BinaryReader 類別的新執行個體，並選擇性地保留資料流開啟狀態。

BinaryReader(Stream)

來源:

BinaryReader.cs

根據指定的資料流並使用 UTF-8 編碼方式，初始化 BinaryReader 類別的新執行個體。

public:
 BinaryReader(System::IO::Stream ^ input);

public BinaryReader (System.IO.Stream input);

new System.IO.BinaryReader : System.IO.Stream -> System.IO.BinaryReader

Public Sub New (input As Stream)

參數

input

Stream

輸入資料流。

例外狀況

ArgumentException

資料流不支援讀取，為 null，或已經關閉。

範例

下列程式碼範例示範如何在檔案中儲存和擷取應用程式設定。

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

備註

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• UTF8Encoding
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

BinaryReader(Stream, Encoding)

來源:

BinaryReader.cs

根據指定的資料流和字元編碼，初始化 BinaryReader 類別的新執行個體。

public:
 BinaryReader(System::IO::Stream ^ input, System::Text::Encoding ^ encoding);

public BinaryReader (System.IO.Stream input, System.Text.Encoding encoding);

new System.IO.BinaryReader : System.IO.Stream * System.Text.Encoding -> System.IO.BinaryReader

Public Sub New (input As Stream, encoding As Encoding)

參數

input

Stream

輸入資料流。

encoding

Encoding

要使用的字元編碼。

例外狀況

ArgumentException

資料流不支援讀取，為 null，或已經關閉。

ArgumentNullException

encoding 為 null。

備註

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

BinaryReader(Stream, Encoding, Boolean)

來源:

BinaryReader.cs

根據指定的資料流和特定的字元編碼，初始化 BinaryReader 類別的新執行個體，並選擇性地保留資料流開啟狀態。

public:
 BinaryReader(System::IO::Stream ^ input, System::Text::Encoding ^ encoding, bool leaveOpen);

public BinaryReader (System.IO.Stream input, System.Text.Encoding encoding, bool leaveOpen);

new System.IO.BinaryReader : System.IO.Stream * System.Text.Encoding * bool -> System.IO.BinaryReader

Public Sub New (input As Stream, encoding As Encoding, leaveOpen As Boolean)

參數

input

Stream

輸入資料流。

encoding

Encoding

要使用的字元編碼。

leaveOpen

Boolean

true 表示在處置 BinaryReader 物件之後，將資料流保持開啟；否則為 false。

例外狀況

ArgumentException

資料流不支援讀取，為 null，或已經關閉。

ArgumentNullException

encoding 或 input 為 null。

另請參閱

• 檔案和資料流程 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案