FileStream.ReadByte メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ソース:

FileStream.cs

ファイルからバイトを読み取り、読み取り位置を 1 バイト進めます。

C#

public override int ReadByte ();

戻り値

Int32

Int32 にキャストしたバイト。ストリームの末尾に達した場合は -1。

例外

NotSupportedException

現在のストリームは読み取りをサポートしません。

ObjectDisposedException

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

例

次のコード例は、ファイルにデータをバイト単位で書き込み、データが正しく書き込まれたことを確認する方法を示しています。

C#

using System;
using System.IO;

class FStream
{
    static void Main()
    {
        const string fileName = "Test#@@#.dat";

        // Create random data to write to the file.
        byte[] dataArray = new byte[100000];
        new Random().NextBytes(dataArray);

        using(FileStream
            fileStream = new FileStream(fileName, FileMode.Create))
        {
            // Write the data to the file, byte by byte.
            for(int i = 0; i < dataArray.Length; i++)
            {
                fileStream.WriteByte(dataArray[i]);
            }

            // Set the stream position to the beginning of the file.
            fileStream.Seek(0, SeekOrigin.Begin);

            // Read and verify the data.
            for(int i = 0; i < fileStream.Length; i++)
            {
                if(dataArray[i] != fileStream.ReadByte())
                {
                    Console.WriteLine("Error writing data.");
                    return;
                }
            }
            Console.WriteLine("The data was written to {0} " +
                "and verified.", fileStream.Name);
        }
    }
}

注釈

このメソッドは、ReadByte をオーバーライドします。

注意

プロパティを使用して、 CanRead 現在のインスタンスが読み取りをサポートしているかどうかを判断します。 詳細については、「CanRead」を参照してください。

注意 (継承者)

の既定の実装 Stream では、新しい 1 バイト配列が作成され、 が呼び出 Read(Byte[], Int32, Int32)されます。 これは正式には正しいですが、非効率的です。 内部バッファーを含むストリームでは、このメソッドをオーバーライドし、バッファーを直接読み取るより効率的なバージョンを提供する必要があります。これにより、すべての呼び出しで余分な配列割り当てが回避されます。

一般的なファイル操作とディレクトリ操作の一覧については、「 一般的な I/O タスク」を参照してください。

適用対象

こちらもご覧ください

• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み