なぜあなたのコードは「勝手に書き換わる」のか？VB.NETにおけるByValとByRefの絶対的境界線
業務自動化の現場で、ある日突然発生する「値がどこかで書き換わっている」という悪夢。デバッガを追いかけても犯人が見つからない。その原因の9割は、`ByVal`と`ByRef`というVB.NETの根幹をなす概念への理解不足にあります。
「とりあえず動く」コードから、「予測可能で堅牢な」コードへ。プロフェッショナルとして、メモリの挙動からこの問題を解剖します。
—
1. 概念の再定義：メモリ上で何が起きているか
VB.NETにおける引数の受け渡しは、単なる記法の違いではありません。「値のコピーを渡すのか」それとも「メモリアドレス（ポインタ）を渡すのか」という、メモリ管理の根本的な分岐点です。
- ByVal（値渡し）: 変数の「値」を複製して渡します。メソッド内で何をしようが、呼び出し元の変数は安全です。
- ByRef（参照渡し）: 変数が存在する「場所（アドレス）」を渡します。メソッド内で引数を書き換えれば、呼び出し元の変数も即座に書き換わります。
実務における鉄則は「デフォルトは常にByVal」です。ByRefが必要なのは、戻り値以外に値を返却したいという明確な設計意図がある時だけです。
—
2. 破壊的バグを生むコード vs 防御的設計
まずは、ByRefを安易に使った結果、バグを招く「やってはいけない例」を見てみましょう。
アンチパターン：意図しない副作用
‘ 呼び出し元
Dim accountBalance As Decimal = 1000
CalculateBonus(accountBalance)
‘ 結果：accountBalance は 1000 のままを期待しているのに、なぜか 1100 になっている！？
‘ 危険なメソッド定義
Private Sub CalculateBonus(ByRef balance As Decimal)
‘ ByRefで受け取ったため、元の変数そのものを操作してしまう
balance = balance + 100
End Sub
このコードの何が問題か？ それは、メソッド呼び出し側が「値が書き換わる可能性がある」ことをコードから直感的に判断できない点です。これは保守性を著しく低下させます。
—
3. 実践：堅牢なコードを構築するベストプラクティス
業務自動化ツールにおいて、データベースやファイル操作を行う際、引数の意図を明確にすることは「バグを未然に防ぐ最強の防御壁」です。
推奨パターン：関数型アプローチ
値を加工して返却したい場合は、ByRefで副作用を起こすのではなく、新しい値を戻り値として返すべきです。
”’
”’
Public Function CalculateBonus(ByVal balance As Decimal) As Decimal
‘ 引数はByValでコピーとして受け取るため、元の変数は保護される
Dim bonus As Decimal = balance 0.1D
Return balance + bonus
End Function
‘ 呼び出し側
Dim originalBalance As Decimal = 1000
Dim newBalance As Decimal = CalculateBonus(originalBalance)
‘ originalBalanceは1000のまま、newBalanceに1100が代入される（安全！）
—
4. プロの視点：参照型（Object/Class）の罠
ここからが中級者へのステップアップです。`Integer`などの「値型」だけでなく、`DataTable`や`List(Of T)`などの「参照型」を渡すとき、話はさらに複雑になります。
参照型は、`ByVal`であっても「中身」は書き換え可能です。
- `ByVal`：参照先（アドレス）のコピーを渡す。→ アドレスは変えられないが、アドレス先にあるデータは操作できる。
- `ByRef`：参照先そのものを渡す。→ 参照先自体を別のオブジェクトに差し替えることができる。
実務でデータベースから取得した`DataTable`をメソッドに渡す際は、そのメソッドが「データの追加・削除」を行うのか、「テーブルの参照先を入れ替えるのか」を明確に区別しなければなりません。
—
5. まとめ：今日から守るべき設計規約
最後に、あなたが現場でコードを書く際に守るべき「極限のルール」を提示します。
1. ByRefは原則禁止: どうしても必要な場合（Tryパターン等）を除き、使用を禁じる。
2. ByValを明示せよ: VB.NETはデフォルトがByValですが、あえて明示的に記述することで、読み手（および未来の自分）に「このメソッドは引数を書き換えない」という意思表示をせよ。
3. イミュータブル（不変）を意識: データを加工する際は、元の変数を書き換えるのではなく、新しいオブジェクトを作成して返す設計を優先せよ。
コードは「書く」ものではなく、「読みやすく設計する」ものです。メモリの挙動まで意識した設計ができれば、あなたの自動化ツールは、誰がメンテナンスしても壊れない「伝説のツール」へと進化するはずです。
さあ、エディタを開き、あなたのコードの`ByRef`をすべて見直すことから始めましょう。それが、一流エンジニアへの第一歩です。
