FileStream.WriteByte(Byte) メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ソース:

FileStream.cs

ファイル ストリームの現在位置にバイトを書き込みます。

C#

public override void WriteByte (byte value);

パラメーター

value

Byte

ストリームに書き込むバイト。

例外

ObjectDisposedException

ストリームは閉じられています。

NotSupportedException

ストリームは書き込みをサポートしません。

IOException

.NET 8 以降のバージョン: 基になるパイプが閉じているか、切断されています。

例

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

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);
        }
    }
}

注釈

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

を使用して WriteByte 、 に効率的にバイトを FileStream 書き込みます。 ストリームが閉じているか、書き込み不可の場合は、例外がスローされます。

注意

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

注意 (継承者)

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

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

適用対象

こちらもご覧ください

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