VB.NETでバイナリを制する：BinaryReader/Writerによる堅牢な独自フォーマット実装術
業務システムにおいて、CSVやJSONだけでは立ち行かない場面がある。大量のセンサーデータ、画像ヘッダーの解析、あるいは外部ベンダーから送られてくる謎の独自プロトコル――。これらを「なんとなく」扱うと、メモリリークやエンディアンの不整合、あるいはファイル破損という悪夢が待っている。
今日は、VB.NETでバイナリデータを「プロフェッショナルとして」正確かつ高速にハンドリングするための設計指針を授ける。
—
1. なぜ「ストリーム」を意識するのか
初心者はファイルを一度メモリに全展開しようとする。これは業務アプリケーションにおける最大の悪手だ。数GBのファイルを読み込もうとして `OutOfMemoryException` を吐き出すシステムを、私は数多く見てきた。
`BinaryReader` と `BinaryWriter` は、「ストリーム（流れるデータ）」を扱うためのインターフェースだ。ファイルを一度に読み込むのではなく、必要な分だけポインタを進めながら抽出する。この設計思想を維持することこそが、堅牢なシステムの第一歩である。
—
2. 堅牢な実装のための黄金パターン
バイナリ解析で最も恐ろしいのは「想定外のデータ構造」だ。読み込み時に必ず構造を検証する「Guard Clause（ガード節）」を組み込むのが、現場のリーダーとしての流儀だ。
以下に、独自フォーマット（ヘッダー＋データ列）を読み書きする、保守性の高いテンプレートを示す。
独自フォーマット書き込み実装例
Imports System.IO
Public Sub WriteBinaryData(filePath As String, dataList As List(Of Integer))
‘ FileStreamを確実に閉じるため、Usingステートメントは必須
Using fs As New FileStream(filePath, FileMode.Create, FileAccess.Write, FileShare.None)
Using writer As New BinaryWriter(fs, System.Text.Encoding.UTF8)
‘ ヘッダー：識別子（マジックナンバー）を書き込み、ファイル形式を保証する
writer.Write(“MY_FMT”c)
‘ バージョン管理：将来の改修に備える
writer.Write(1)
‘ データ数：読み込み時のループ制御に利用
writer.Write(dataList.Count)
For Each item In dataList
writer.Write(item)
Next
End Using
End Using
End Sub
堅牢な読み込み実装例（検証付き）
Public Function ReadBinaryData(filePath As String) As List(Of Integer)
Dim result As New List(Of Integer)()
Using fs As New FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read)
Using reader As New BinaryReader(fs, System.Text.Encoding.UTF8)
‘ 1. マジックナンバーの検証（ファイル形式の不一致を即座に検知）
If reader.ReadString() <> “MY_FMT” Then
Throw New InvalidDataException(“不明なファイル形式です。”)
End If
‘ 2. バージョンの確認
Dim version As Integer = reader.ReadInt32()
‘ 3. データ数の読み込み
Dim count As Integer = reader.ReadInt32()
‘ 4. ループ処理
For i As Integer = 0 To count – 1
result.Add(reader.ReadInt32())
Next
End Using
End Using
Return result
End Function
—
3. 実務で必ず陥る「3つの罠」
① エンディアンの問題
.NETの `BinaryReader` はデフォルトでリトルエンディアンで動作する。もしネットワーク機器やレガシーなメインフレームから出力されたバイナリを扱う場合、ビッグエンディアンへの変換が必要になる。VB.NET標準の `BinaryReader` だけでは力不足なため、`Array.Reverse` を活用してバイト順を入れ替える必要があることを忘れてはならない。
② ファイルロックと排他制御
実務環境では、別プロセスがファイルを掴んでいるケースが多い。`FileShare.None` を適切に指定し、アクセスエラー発生時にはリトライ処理を挟むのがプロダクションコードの作法だ。
③ 文字コードの罠
`BinaryWriter.Write(string)` は、文字列の長さを示すプレフィックス（7ビットエンコードされた長さ）を自動付与する。もし相手先フォーマットが「固定長文字列」や「NULL終端文字列」を求めている場合、標準の `Write` メソッドは使えない。その場合は、`Encoding.GetBytes` を使って手動でバイト配列に変換し、書き込む必要がある。
—
結論：バイナリは「行儀よく」扱う
バイナリデータの読み書きは、メモリとディスクの境界を直接操作する繊細な作業だ。
- Usingブロックでリソースを解放せよ。
- マジックナンバーでファイルの正当性を検証せよ。
- 読み込む前に「サイズ」を信頼するな（バッファオーバーランを防ぐ）。
この3つを守るだけで、あなたの書くツールは、数年後もメンテナンス可能な「資産」に変わる。場当たり的な `ReadBytes` の連発は卒業し、構造的で美しいバイナリハンドリングを実装してほしい。
それができるエンジニアこそが、現場をリードする真のアーキテクトだ。
