BinaryReader.ReadByte メソッド

.NET Framework クラス ライブラリ リファレンス

BinaryReader.ReadByte メソッド

現在のストリームから次のバイトを読み取り、ストリームの現在位置を 1 バイトだけ進めます。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ReadByte As Byte

Visual Basic (使用法)

Dim instance As BinaryReader
Dim returnValue As Byte

returnValue = instance.ReadByte

C#

public virtual byte ReadByte ()

C++

public:
virtual unsigned char ReadByte ()

J#

public byte ReadByte ()

JScript

public function ReadByte () : byte

戻り値
現在のストリームから読み取った次のバイト。

例外

例外の種類	条件
EndOfStreamException	ストリームの末尾に到達しました。
ObjectDisposedException	ストリームが閉じられました。
IOException	I/O エラーが発生しました。

解説

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

データ形式が競合するため、このメソッドを次のエンコーディングで使用することはお勧めしません。

• UTF-7

• ISO-2022-JP

• ISCII

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	方法 : ファイルにテキストを書き込む
テキスト ファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキスト ファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログ ファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリ ファイルから読み取る。	方法 : 新しく作成されたデータ ファイルに対して読み書きする
バイナリ ファイルに書き込む。	方法 : 新しく作成されたデータ ファイルに対して読み書きする

使用例

メモリをバッキング ストアとして使用してバイナリ データを書き込み、さらにデータが正常に書き込まれたことを確認する例を次に示します。

Visual Basic

Imports System
Imports System.IO

Public Class BinaryRW

    Shared Sub Main()
    
        Dim i As Integer
 = 0

        ' Create random data to write to the stream.
        Dim writeArray(1000) As Byte
        Dim randomGenerator As New
 Random()
        randomGenerator.NextBytes(writeArray)

        Dim binWriter As New
 BinaryWriter(New MemoryStream())
        Dim binReader As New
 BinaryReader(binWriter.BaseStream)

        Try
        
            ' Write the data to the stream.
            Console.WriteLine("Writing the data.")
            For i = 0 To writeArray.Length
 - 1
                binWriter.Write(writeArray(i))
            Next i

            ' Set the stream position to the beginning of the stream.
            binReader.BaseStream.Position = 0

            ' Read and verify the data from the stream.
            For i = 0 To writeArray.Length
 - 1
                If binReader.ReadByte() <> writeArray(i)
 Then
                    Console.WriteLine("Error writing the data.")
                    Return
                End If
            Next i
            Console.WriteLine("The data was written and verified.")

        ' Catch the EndOfStreamException and write an error message.
        Catch ex As EndOfStreamException
            Console.WriteLine("Error writing the data: {0}",
 _
                ex.GetType().Name)
        End Try
    
    End Sub
End Class

C#

using System;
using System.IO;

class BinaryRW
{
    static void Main()
    {
        int i = 0;

        // Create random data to write to the stream.
        byte[] writeArray = new byte[1000];
        new Random().NextBytes(writeArray);

        BinaryWriter binWriter = new BinaryWriter(new
 MemoryStream());
        BinaryReader binReader = 
            new BinaryReader(binWriter.BaseStream);

        try
        {
            // Write the data to the stream.
            Console.WriteLine("Writing the data.");
            for(i = 0; i < writeArray.Length; i++)
            {
                binWriter.Write(writeArray[i]);
            }

            // Set the stream position to the beginning of the stream.
            binReader.BaseStream.Position = 0;

            // Read and verify the data from the stream.
            for(i = 0; i < writeArray.Length; i++)
            {
                if(binReader.ReadByte() != writeArray[i])
                {
                    Console.WriteLine("Error writing the data.");
                    return;
                }
            }
            Console.WriteLine("The data was written and verified.");
        }

        // Catch the EndOfStreamException and write an error message.
        catch(EndOfStreamException e)
        {
            Console.WriteLine("Error writing the data.\n{0}",
                e.GetType().Name);
        }
    }
}

C++

using namespace System;
using namespace System::IO;
int main()
{
   int i = 0;
   
   // Create random data to write to the stream.
   array<Byte>^writeArray = gcnew array<Byte>(1000);
   (gcnew Random)->NextBytes( writeArray );
   BinaryWriter^ binWriter = gcnew BinaryWriter( gcnew MemoryStream );
   BinaryReader^ binReader = gcnew BinaryReader( binWriter->BaseStream );
   try
   {
      
      // Write the data to the stream.
      Console::WriteLine( "Writing the data." );
      for ( i = 0; i < writeArray->Length; i++ )
      {
         binWriter->Write( writeArray[ i ] );

      }
      
      // Set the stream position to the beginning of the stream.
      binReader->BaseStream->Position = 0;
      
      // Read and verify the data from the stream.
      for ( i = 0; i < writeArray->Length; i++ )
      {
         if ( binReader->ReadByte() != writeArray[ i ] )
         {
            Console::WriteLine( "Error writing the data." );
            return  -1;
         }

      }
      Console::WriteLine( "The data was written and verified." );
   }
   // Catch the EndOfStreamException and write an error message.
   catch ( EndOfStreamException^ e ) 
   {
      Console::WriteLine( "Error writing the data.\n{0}", e->GetType()->Name
 );
   }

}

J#

import System.*;
import System.IO.*;

class BinaryRW
{   
    public static void main(String[]
 args)
    {
        int i = 0;

        // Create random data to write to the stream.
        ubyte writeArray[] = new ubyte[1000];
        new Random().NextBytes(writeArray);

        BinaryWriter binWriter = new BinaryWriter(new
 MemoryStream());
        BinaryReader binReader = new BinaryReader(binWriter.get_BaseStream());

        try {
            // Write the data to the stream.
            Console.WriteLine("Writing the data.");
            for(i = 0;i < writeArray.length;i++) {
                binWriter.Write(writeArray);                
            } 

            // Set the stream position to the beginning of the stream.
            binReader.get_BaseStream().set_Position(0);

            // Read and verify the data from the stream.
            for(i = 0;i < writeArray.length;i++) {
                if ( binReader.ReadByte() != writeArray[i] ) {
                    Console.WriteLine("Error writing the data.");
                    return;
                }
            }
            Console.WriteLine("The data was written and verified.");
        }
        // Catch the EndOfStreamException and write an error message.
        catch(EndOfStreamException e) {
            Console.WriteLine("Error writing the data.\n{0}",
                e.GetType().get_Name());
        }
    } //main
} //BinaryRW

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
BinaryReader クラス
BinaryReader メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む