BinaryReader.Read メソッド

定義

名前空間:: System.IO

アセンブリ:: mscorlib.dll, System.IO.dll

アセンブリ:: netstandard.dll, System.Runtime.dll

アセンブリ:: System.IO.dll

アセンブリ:: System.Runtime.Extensions.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

基になるストリームからバイトを読み取り、ストリームの現在位置を進めます。

オーバーロード

名前	説明
Read()	基になるストリームから文字を読み取り、使用されている `Encoding` とストリームから読み取られる特定の文字に従って、ストリームの現在位置を進めます。
Read(Span<Byte>)	現在のストリームからバイトシーケンスを読み取り、読み取ったバイト数だけストリーム内の位置を進めます。
Read(Span<Char>)	現在のストリームから、指定されたバッファーの長さと同じ文字数を読み取り、それらを指定されたバッファーに書き込み、使用される `Encoding` とストリームから読み取られる特定の文字に従って現在の位置を進めます。
Read(Byte[], Int32, Int32)	バイト配列内の指定したポイントから開始して、指定したバイト数をストリームから読み取ります。
Read(Char[], Int32, Int32)	指定した数の文字をストリームから読み取ります。これは、文字配列内の指定したポイントから始まります。

Read()

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

基になるストリームから文字を読み取り、使用されている Encoding とストリームから読み取られる特定の文字に従って、ストリームの現在位置を進めます。

public:
 virtual int Read();

public virtual int Read();

abstract member Read : unit -> int
override this.Read : unit -> int

Public Overridable Function Read () As Integer

返品

Int32

入力ストリームの次の文字。現在使用できる文字がない場合は -1。

例外

IOException

I/O エラーが発生しました。

ObjectDisposedException

ストリームが閉じられます。

例

次の例は、バッキングストアとしてメモリを使用してデータを読み書きする方法を示しています。次の使用例は、無効なファイルパス文字の一覧をコンソールに表示します。コードはすべての無効なファイルパス文字の一覧を表示しようとしますが、すべての文字が表示可能な文字セット内にあるわけではありません。無効な文字の一覧はシステムによって異なる場合があるため、このコードの出力も異なる場合があります。

using System;
using System.IO;

class BinaryRW
{
    static void Main()
    {
        int i = 0;
        char[] invalidPathChars = Path.InvalidPathChars;
        MemoryStream memStream = new MemoryStream();
        BinaryWriter binWriter = new BinaryWriter(memStream);

        // Write to memory.
        binWriter.Write("Invalid file path characters are: ");
        for(i = 0; i < invalidPathChars.Length; i++)
        {
            binWriter.Write(invalidPathChars[i]);
        }

        // Create the reader using the same MemoryStream
        // as used with the writer.
        BinaryReader binReader = new BinaryReader(memStream);

        // Set Position to the beginning of the stream.
        memStream.Position = 0;

        // Read the data from memory and write it to the console.
        Console.Write(binReader.ReadString());
        char[] memoryData =
            new char[memStream.Length - memStream.Position];
        for(i = 0; i < memoryData.Length; i++)
        {
            memoryData[i] = Convert.ToChar(binReader.Read());
        }
        Console.WriteLine(memoryData);
    }
}

open System
open System.IO

let invalidPathChars = Path.GetInvalidPathChars()
let memStream = new MemoryStream()
let binWriter = new BinaryWriter(memStream)

// Write to memory.
printf "Invalid file path characters are: "
for i = 0 to invalidPathChars.Length - 1 do
    binWriter.Write invalidPathChars[i]

// Create the reader using the same MemoryStream
// as used with the writer.
let binReader = new BinaryReader(memStream)

// Set Position to the beginning of the stream.
memStream.Position <- 0

// Read the data from memory and write it to the console.
printf $"{binReader.ReadString()}"
let memoryData =
    [| for _ = 0L to memStream.Length - memStream.Position - 1L do
        Convert.ToChar(binReader.Read()) |]
printfn $"{memoryData}"

Imports System.IO

Public Class BinaryRW

    Shared Sub Main()
    
        Dim i As Integer = 0
        Dim invalidPathChars() As Char = Path.InvalidPathChars
        Dim memStream As new MemoryStream()
        Dim binWriter As New BinaryWriter(memStream)

        ' Write to memory.
        binWriter.Write("Invalid file path characters are: ")
        For i = 0 To invalidPathChars.Length - 1
            binWriter.Write(invalidPathChars(i))
        Next i

        ' Create the reader using the same MemoryStream 
        ' as used with the writer.
        Dim binReader As New BinaryReader(memStream)

        ' Set Position to the beginning of the stream.
        memStream.Position = 0

        ' Read the data from memory and write it to the console.
        Console.Write(binReader.ReadString())
        Dim memoryData( _
            CInt(memStream.Length - memStream.Position) - 1) As Char
        For i = 0 To memoryData.Length - 1
            memoryData(i) = Convert.ToChar(binReader.Read())
        Next i
        Console.WriteLine(memoryData)
    
    End Sub
End Class

注釈

BinaryReader は、読み取りの失敗後にファイルの位置を復元しません。

一般的な I/O タスクの一覧については、「一般的な I/O タスク」を参照してください。

こちらもご覧ください

適用対象

Read(Span<Byte>)

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

現在のストリームからバイトシーケンスを読み取り、読み取ったバイト数だけストリーム内の位置を進めます。

public:
 virtual int Read(Span<System::Byte> buffer);

public virtual int Read(Span<byte> buffer);

abstract member Read : Span<byte> -> int
override this.Read : Span<byte> -> int

Public Overridable Function Read (buffer As Span(Of Byte)) As Integer

パラメーター

buffer: Span<Byte>

メモリの領域。このメソッドから制御が戻ると、この領域の内容は現在のソースから読み取られたバイトに置き換えられます。

返品

Int32

バッファーに読み込まれるバイトの合計数。この値は、バッファーに割り当てられたバイト数より小さい場合があります (そのバイト数が現在使用できない場合)。ストリームの末尾に達した場合は 0 になります。

例外

ObjectDisposedException

ストリームが閉じられます。

IOException

I/O エラーが発生しました。

適用対象

Read(Span<Char>)

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

現在のストリームから、指定されたバッファーの長さと同じ文字数を読み取り、それらを指定されたバッファーに書き込み、使用される Encoding とストリームから読み取られる特定の文字に従って現在の位置を進めます。

public:
 virtual int Read(Span<char> buffer);

public virtual int Read(Span<char> buffer);

abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int

Public Overridable Function Read (buffer As Span(Of Char)) As Integer

パラメーター

buffer: Span<Char>

文字のスパン。このメソッドが戻ると、この領域の内容は、現在のソースから読み取られた文字に置き換えられます。

返品

Int32

バッファーに読み込まれる文字数の合計。多くの文字が現在使用できない場合は、要求された文字数より小さいか、ストリームの末尾に達した場合は 0 になる可能性があります。

例外

ObjectDisposedException

ストリームが閉じられます。

IOException

I/O エラーが発生しました。

適用対象

Read(Byte[], Int32, Int32)

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

バイト配列内の指定したポイントから開始して、指定したバイト数をストリームから読み取ります。

public:
 virtual int Read(cli::array <System::Byte> ^ buffer, int index, int count);

public virtual int Read(byte[] buffer, int index, int count);

abstract member Read : byte[] * int * int -> int
override this.Read : byte[] * int * int -> int

Public Overridable Function Read (buffer As Byte(), index As Integer, count As Integer) As Integer

パラメーター

buffer: Byte[]

データを読み取るバッファー。

index: Int32

バッファーへの読み取りを開始するバッファー内の開始点。

count: Int32

読み取るバイト数。

返品

Int32

bufferに読み取られたバイト数。この値は、多くのバイトが使用できない場合は要求されたバイト数より小さいか、ストリームの末尾に達した場合は 0 になる可能性があります。

例外

ArgumentException

バッファーの長さから index を引いた値は、count未満です。

-又は-

読み取るデコードされた文字の数が countを超える。これは、Unicode デコーダーがフォールバック文字またはサロゲートペアを返す場合に発生する可能性があります。

ArgumentNullException

buffer は nullです。

ArgumentOutOfRangeException

index または count が負の値です。

ObjectDisposedException

ストリームが閉じられます。

IOException

I/O エラーが発生しました。

例

次の例は、バッキングストアとしてメモリを使用してバイナリデータを書き込む方法を示しています。データが正しく書き込まれたかどうかを示すメッセージがコンソールに表示されます。

using System;
using System.IO;

namespace BinaryRW
{
    class Program
    {
        static void Main(string[] args)
        {
            const int arrayLength = 1000;
            byte[] dataArray = new byte[arrayLength];
            byte[] verifyArray = new byte[arrayLength];

            new Random().NextBytes(dataArray);

            using (BinaryWriter binWriter = new BinaryWriter(new MemoryStream()))
            {
                Console.WriteLine("Writing the data.");
                binWriter.Write(dataArray, 0, arrayLength);

                using (BinaryReader binReader = new BinaryReader(binWriter.BaseStream))
                {
                    binReader.BaseStream.Position = 0;

                    if (binReader.Read(verifyArray, 0, arrayLength) != arrayLength)
                    {
                        Console.WriteLine("Error writing the data.");
                        return;
                    }
                }
            }

            for (int i = 0; i < arrayLength; i++)
            {
                if (verifyArray[i] != dataArray[i])
                {
                    Console.WriteLine("Error writing the data.");
                    return;
                }
            }

            Console.WriteLine("The data was written and verified.");
        }
    }
}

open System
open System.IO

let arrayLength = 1000
let dataArray = Array.zeroCreate<byte> arrayLength
let verifyArray = Array.zeroCreate<byte> arrayLength

Random().NextBytes dataArray

do
    use binWriter = new BinaryWriter(new MemoryStream())
    printfn "Writing the data."
    binWriter.Write(dataArray, 0, arrayLength)

    use binReader = new BinaryReader(binWriter.BaseStream)
    binReader.BaseStream.Position <- 0

    if binReader.Read(verifyArray, 0, arrayLength) <> arrayLength then
        printfn "Error writing the data."
    else
        for i = 0 to arrayLength - 1 do
            if verifyArray[i] <> dataArray[i] then
                printfn "Error writing the data."
            else
                printfn "The data was written and verified."

Imports System.IO

Module Module1

    Sub Main()
        Const upperBound As Integer = 1000
        Dim dataArray(upperBound) As Byte
        Dim verifyArray(upperBound) As Byte

        Dim randomGenerator As New Random
        randomGenerator.NextBytes(dataArray)

        Using binWriter As New BinaryWriter(New MemoryStream())
            Console.WriteLine("Writing the data.")
            binWriter.Write(dataArray, 0, dataArray.Length)

            Using binReader As New BinaryReader(binWriter.BaseStream)
                binReader.BaseStream.Position = 0

                If binReader.Read(verifyArray, 0, dataArray.Length) <> dataArray.Length Then
                    Console.WriteLine("Error writing the data.")
                    Return
                End If
            End Using
        End Using

        For i As Integer = 0 To upperBound
            If verifyArray(i) <> dataArray(i) Then
                Console.WriteLine("Error writing the data.")
                Return
            End If
        Next i

        Console.WriteLine("The data was written and verified.")
    End Sub

End Module

次の使用例は、ファイルの内容を読み取り、各バイトの数値を 16 列の形式で表示します。 Read メソッドが 0 バイトを返すと、読み取られるファイルの末尾が検出されます。

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

public class DumpFileSample
{
    private static readonly int CHUNK_SIZE = 1024;
    public static void Main(String[] args)
    {
        if ((args.Length == 0) || !File.Exists(args[0]))
        {
            Console.WriteLine("Please provide an existing file name.");
        }
        else
        {
            using (FileStream fs = new FileStream(args[0], FileMode.Open, FileAccess.Read))
            {
                using (BinaryReader br = new BinaryReader(fs, new ASCIIEncoding()))
                {
                    byte[] chunk;

                    chunk = br.ReadBytes(CHUNK_SIZE);
                    while(chunk.Length > 0)
                    {
                        DumpBytes(chunk, chunk.Length);
                        chunk = br.ReadBytes(CHUNK_SIZE);
                    }
                }
            }
        }
    }

    public static void DumpBytes(byte[] bdata, int len)
    {
        int i;
        int j = 0;
        char dchar;
        // 3 * 16 chars for hex display, 16 chars for text and 8 chars
        // for the 'gutter' int the middle.
        StringBuilder dumptext = new StringBuilder("        ", 16 * 4 + 8);
        for (i = 0; i < len; i++)
        {
            dumptext.Insert(j * 3, String.Format("{0:X2} ", (int)bdata[i]));
            dchar = (char)bdata[i];
            //' replace 'non-printable' chars with a '.'.
            if (Char.IsWhiteSpace(dchar) || Char.IsControl(dchar))
            {
                dchar = '.';
            }
            dumptext.Append(dchar);
            j++;
            if (j == 16)
            {
                Console.WriteLine(dumptext);
                dumptext.Length = 0;
                dumptext.Append("        ");
                j = 0;
            }
        }
        // display the remaining line
        if (j > 0)
        {
            for (i = j; i < 16; i++)
            {
                dumptext.Insert(j * 3, "   ");
            }
            Console.WriteLine(dumptext);
        }
    }
}

open System
open System.IO
open System.Text

let CHUNK_SIZE = 1024

let dumpBytes (bdata: byte[]) len =
    let mutable j = 0
    // 3 * 16 chars for hex display, 16 chars for text and 8 chars
    // for the 'gutter' int the middle.
    let dumptext = StringBuilder("        ", 16 * 4 + 8)
    for i = 0 to len - 1 do
        dumptext.Insert(j * 3, $"{int bdata[i]:X2} ") |> ignore
        let dchar = char bdata[i]
        //' replace 'non-printable' chars with a '.'.
        let dchar = 
            if Char.IsWhiteSpace dchar || Char.IsControl dchar then
                '.'
            else 
                dchar
        dumptext.Append dchar |> ignore
        j <- j + 1
        if j = 16 then
            printfn $"{dumptext}"
            dumptext.Length <- 0
            dumptext.Append "        " |> ignore
            j <- 0
    // display the remaining line
    if j > 0 then
        for i = j to 15 do
            dumptext.Insert(j * 3, "   ") |> ignore
        printfn $"{dumptext}"

[<EntryPoint>]
let main args =
    if args.Length = 0 || File.Exists args[0] |> not then
        printfn "Please provide an existing file name."
    else
        use fs = new FileStream(args[0], FileMode.Open, FileAccess.Read)
        use br = new BinaryReader(fs, ASCIIEncoding())
        
        let mutable chunk = br.ReadBytes CHUNK_SIZE
        while chunk.Length > 0 do
            dumpBytes chunk chunk.Length
            chunk <- br.ReadBytes CHUNK_SIZE
    0

Imports System.IO
Imports System.Text

Module Module1
    Private ReadOnly CHUNK_SIZE As Integer = 1024
    Public Sub Main(args() As String)
        If ((args.Length = 0) OrElse Not File.Exists(args(0))) Then
            Console.WriteLine("Please provide an existing file name.")
        Else
            Using fs As FileStream = New FileStream(args(0), FileMode.Open, FileAccess.Read)
                Using br As New BinaryReader(fs, New ASCIIEncoding())
                    Dim chunk(CHUNK_SIZE) As Byte
                    chunk = br.ReadBytes(CHUNK_SIZE)

                    While chunk.Length > 0
                        DumpBytes(chunk, chunk.Length)
                        chunk = br.ReadBytes(CHUNK_SIZE)
                    End While
                End Using
            End Using
        End If
    End Sub

    Public Sub DumpBytes(bdata() As Byte, len As Integer)
        Dim i As Integer
        Dim j As Integer = 0
        Dim dchar As Char
        ' 3 * 16 chars for hex display, 16 chars for text and 8 chars
        ' for the 'gutter' int the middle.
        Dim dumptext As New StringBuilder("        ", 16 * 4 + 8)
        For i = 0 To len - 1
            dumptext.Insert(j * 3, String.Format("{0:X2} ", CType(bdata(i), Integer)))
            dchar = Convert.ToChar(bdata(i))
            ' replace 'non-printable' chars with a '.'.
            If Char.IsWhiteSpace(dchar) Or Char.IsControl(dchar) Then
                dchar = "."
            End If
            dumptext.Append(dchar)
            j += 1
            If j = 16 Then
                Console.WriteLine(dumptext)
                dumptext.Length = 0
                dumptext.Append("        ")
                j = 0
            End If
        Next i
        ' display the remaining line
        If j > 0 Then
            ' add blank hex spots to align the 'gutter'.
            For i = j To 15
                dumptext.Insert(j * 3, "   ")
            Next i
            Console.WriteLine(dumptext)
        End If
    End Sub

End Module

注釈

BinaryReader は、読み取り操作が失敗した後にファイルの位置を復元しません。

一般的な I/O タスクの一覧については、「一般的な I/O タスク」を参照してください。

こちらもご覧ください

適用対象

Read(Char[], Int32, Int32)

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

ソース:: BinaryReader.cs

指定した数の文字をストリームから読み取ります。これは、文字配列内の指定したポイントから始まります。

public:
 virtual int Read(cli::array <char> ^ buffer, int index, int count);

public virtual int Read(char[] buffer, int index, int count);

abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int

Public Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

パラメーター

buffer: Char[]

データを読み取るバッファー。

index: Int32

バッファーへの読み取りを開始するバッファー内の開始点。

count: Int32

読み取る文字数。

返品

Int32

例外

ArgumentException

バッファーの長さから index を引いた値は、count未満です。

-又は-

ArgumentNullException

buffer は nullです。

ArgumentOutOfRangeException

index または count が負の値です。

ObjectDisposedException

ストリームが閉じられます。

IOException

I/O エラーが発生しました。

例

using System;
using System.IO;

class BinaryRW
{
    static void Main()
    {
        char[] invalidPathChars = Path.InvalidPathChars;
        MemoryStream memStream = new MemoryStream();
        BinaryWriter binWriter = new BinaryWriter(memStream);

        // Write to memory.
        binWriter.Write("Invalid file path characters are: ");
        binWriter.Write(
            Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);

        // Create the reader using the same MemoryStream
        // as used with the writer.
        BinaryReader binReader = new BinaryReader(memStream);

        // Set Position to the beginning of the stream.
        memStream.Position = 0;

        // Read the data from memory and write it to the console.
        Console.Write(binReader.ReadString());
        int arraySize = (int)(memStream.Length - memStream.Position);
        char[] memoryData = new char[arraySize];
        binReader.Read(memoryData, 0, arraySize);
        Console.WriteLine(memoryData);
    }
}

open System.IO

let invalidPathChars = Path.GetInvalidPathChars()
let memStream = new MemoryStream()
let binWriter = new BinaryWriter(memStream)

// Write to memory.
binWriter.Write "Invalid file path characters are: "
binWriter.Write(invalidPathChars, 0, invalidPathChars.Length)

// Create the reader using the same MemoryStream
// as used with the writer.
let binReader = new BinaryReader(memStream)

// Set Position to the beginning of the stream.
memStream.Position <- 0

// Read the data from memory and write it to the console.
printf $"{binReader.ReadString()}"
let arraySize = memStream.Length - memStream.Position |> int
let memoryData = Array.zeroCreate<char> arraySize
binReader.Read(memoryData, 0, arraySize) |> ignore
printfn $"{memoryData}"

Imports System.IO

Public Class BinaryRW

    Shared Sub Main()
    
        Dim invalidPathChars() As Char = Path.InvalidPathChars
        Dim memStream As new MemoryStream()
        Dim binWriter As New BinaryWriter(memStream)

        ' Write to memory.
        binWriter.Write("Invalid file path characters are: ")
        binWriter.Write(Path.InvalidPathChars, 0, _
            Path.InvalidPathChars.Length)

        ' Create the reader using the same MemoryStream 
        ' as used with the writer.
        Dim binReader As New BinaryReader(memStream)

        ' Set Position to the beginning of the stream.
        memStream.Position = 0

        ' Read the data from memory and write it to the console.
        Console.Write(binReader.ReadString())
        Dim upperBound As Integer = _
            CInt(memStream.Length - memStream.Position) - 1
        Dim memoryData(upperBound) As Char
        binReader.Read(memoryData, 0, upperBound)
        Console.WriteLine(memoryData)
    
    End Sub
End Class

注釈

BinaryReader は、読み取り操作が失敗した後にファイルの位置を復元しません。

一般的な I/O タスクの一覧については、「一般的な I/O タスク」を参照してください。

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?