「New」省略？VB.NET配列宣言の落とし穴：NullReferenceExceptionを回避し、堅牢なコードを書く秘訣
皆さん、こんにちは。プロジェクトリーダーの〇〇です。
日々の業務で、VB.NETを使って自動化ツールや業務アプリケーションを開発されていることと思います。そこで今回は、VB.NETにおける配列の宣言と初期化について、初心者が陥りがちな「罠」とその回避策に焦点を当てて解説します。特に、「`New`」キーワードの省略やサイズ指定における注意点は、後々深刻なバグ、特に`NullReferenceException`を引き起こす元凶となりがちです。
本記事では、単なる構文の解説に留まらず、なぜその書き方が非効率なのか、どう設計すべきかを、現場のリーダーが部下に指示するように、ロジカルかつシャープに伝授します。ファイル連携やデータベース連携といった、実務で頻繁に遭遇するシナリオでの注意点、そしてコピペでそのまま使える、保守性の高いプロダクションコード例を交えて、皆さんの開発スキルを一段階引き上げます。
1. 配列宣言の基本：なぜ「New」が必要なのか？
VB.NETで配列を扱う際、最も基本的な宣言方法は以下の2つです。
パターンA: `Dim` とサイズ指定のみ
.net
‘ 文字列型の配列を宣言
Dim myArray() As String
パターンB: `Dim` と `New`、そしてサイズ指定
.net
‘ 文字列型の配列を宣言し、サイズを10に初期化
Dim myArray(9) As String ‘ インデックスは0からなので、サイズは9まで
ここで、初心者が混乱しやすいのがパターンAです。一見、コードが短くて済むように見えますが、この宣言だけでは、`myArray` は `Nothing` という状態になります。つまり、配列として「何も存在しない」状態です。
「いや、宣言したんだから使えるんじゃないの？」
そう思われた方もいるかもしれません。しかし、ここで「`New`」キーワードを使わずにサイズ指定も行わなかった場合、配列はメモリ上に確保されていません。この状態で `myArray(0)` のような要素にアクセスしようとすると、典型的な `NullReferenceException` が発生します。
なぜ「`New`」が必要なのか？
「`New`」キーワードは、オブジェクトを生成し、メモリ上に確保するために使用されます。配列もオブジェクトの一種です。したがって、配列として要素を格納したり、操作したりするためには、まずメモリ上にその「器」を用意する必要があるのです。
2. サイズ指定の「罠」：インデックスとサイズの混同
配列のサイズ指定において、もう一つよくある間違いが、「サイズ」と「最大インデックス」を混同してしまうことです。
例えば、5つの要素を持つ配列を作成したい場合を考えてみましょう。
間違いやすい例:
.net
‘ 5つの要素を持つ配列を作りたいはずが…
Dim numbers(5) As Integer
このコードでは、`numbers` 配列はインデックス `0` から `5` までの、合計6つの要素を持つことになります。つまり、`numbers(0)`、`numbers(1)`、`numbers(2)`、`numbers(3)`、`numbers(4)`、`numbers(5)` の6つの要素が存在します。
もし、あなたが「5つ」という数を意識して `numbers(4)` までしかアクセスしないつもりだったとしても、この宣言ではインデックス `5` までアクセスできてしまうため、意図しない挙動や、後々バグの原因となる可能性があります。
正しいサイズ指定:
5つの要素を持つ配列を作成したい場合は、最大インデックスを `4` に指定します。
.net
‘ 5つの要素を持つ配列を作成（インデックスは0から4）
Dim numbers(4) As Integer
この場合、`numbers` 配列には `numbers(0)` から `numbers(4)` までの5つの要素が格納できるようになります。
3. 初期化ミスを防ぐ：プロダクションコードの正しい書き方
これらの落とし穴を避けるために、配列を宣言・初期化する際には、以下の点を意識しましょう。
- 必ず「`New`」キーワードで配列を生成する。
- サイズ指定は、必要な要素数から1を引いた値を指定する（最大インデックスを指定する）。
- 初期値も同時に設定したい場合は、配列初期化子 `{}` を使用する。
これらの原則を踏まえた、実務でそのまま使えるプロダクションコード例をいくつか紹介します。
例1：固定サイズの配列を宣言・初期化する
.net
‘ — ファイルパスを格納する配列 —
‘ 5つのファイルパスを格納したい場合
‘ サイズ指定は4（インデックス0～4）
Dim filePaths(4) As String
‘ 初期値も同時に設定する場合（配列初期化子を使用）
Dim fileNames() As String = {“report.txt”, “data.csv”, “config.ini”, “log.txt”}
‘ この場合、配列のサイズは自動的に4（0～3）に決定される
解説:
`filePaths` は、後で各要素に値を代入することを想定した、空の配列として宣言しています。
`fileNames` は、宣言と同時に初期値を設定しています。この場合、`New` キーワードを省略できますが、配列初期化子 `{}` があれば、コンパイラが自動的に配列のサイズを決定してくれるため、サイズ指定を忘れる心配がありません。
例2：ファイルパスのリストを動的に扱う（ArrayList / List(Of T)）
ファイル連携やデータベース連携では、要素数が事前に確定しない場合が多くあります。そのような場合は、`ArrayList`（古い）や `List(Of T>`（推奨）といった、動的にサイズが変更できるコレクションクラスの使用を検討しましょう。
.net
Imports System.Collections.Generic ‘ List(Of T) を使用するために必要
‘ — 処理対象のファイルパスを動的に追加していく場合 —
‘ List(Of String) は、文字列を格納できる動的なリスト
‘ 初期サイズを指定することも可能だが、必須ではない
Dim targetFiles As New List(Of String)()
‘ ファイルパスを追加していく
targetFiles.Add(“C:\Data\Input\file1.txt”)
targetFiles.Add(“C:\Data\Input\file2.csv”)
targetFiles.Add(“C:\Data\Input\file3.xlsx”)
‘ 特定のファイルパスが存在するか確認
If targetFiles.Contains(“C:\Data\Input\file2.csv”) Then
Console.WriteLine(“file2.csv はリストに含まれています。”)
End If
‘ リストの要素数を取得
Dim numberOfFiles As Integer = targetFiles.Count
Console.WriteLine($”処理対象ファイル数: {numberOfFiles}”)
‘ — データベースから取得したレコードのIDを格納する場合 —
Dim recordIds As New List(Of Integer)()
‘ 仮にデータベースからIDを取得したとする
recordIds.Add(101)
recordIds.Add(205)
recordIds.Add(310)
‘ 取得したIDを使って処理を実行
For Each id As Integer In recordIds
Console.WriteLine($”レコードID: {id} を処理中…”)
‘ ここでデータベース操作やファイル生成などの処理を行う
Next
解説:
`List(Of T>` は、`Add` メソッドで要素を簡単に追加でき、`Count` プロパティで現在の要素数を取得できます。配列のように固定サイズではないため、要素数の増減に柔軟に対応できます。
`Imports System.Collections.Generic` をコードの先頭に追加することを忘れないでください。
例3：ファイルパスの配列を直接生成し、ループ処理する
.net
‘ — 特定のディレクトリにあるファイルを列挙し、配列として扱う —
‘ ディレクトリパスを指定
Dim directoryPath As String = “C:\Logs”
‘ 指定したディレクトリ内のすべての .log ファイルを取得し、文字列配列として格納
‘ Path.GetFileName は、ファイルパスからファイル名部分のみを抽出する（例: “C:\Logs\app.log” -> “app.log”）
Dim logFiles() As String = Directory.GetFiles(directoryPath, “.log”).Select(AddressOf Path.GetFileName).ToArray()
‘ ※ Directory.GetFiles はフルパスを返すため、SelectとToArrayでファイル名のみを抽出
‘ ログファイルが存在するかどうかをチェック
If logFiles IsNot Nothing AndAlso logFiles.Length > 0 Then
Console.WriteLine($”{directoryPath} ディレクトリに以下のログファイルが見つかりました:”)
‘ 配列の各要素（ファイル名）をループで処理
For Each fileName As String In logFiles
Console.WriteLine($”- {fileName}”)
‘ ここで各ログファイルに対する処理（読み込み、解析など）を行う
‘ 例: Dim logContent As String = File.ReadAllText(Path.Combine(directoryPath, fileName))
Next
Else
Console.WriteLine($”{directoryPath} ディレクトリにログファイルは見つかりませんでした。”)
End If
解説:
`Directory.GetFiles` は、指定したディレクトリ内のファイルパスの配列を返します。`.Select(AddressOf Path.GetFileName).ToArray()` を使うことで、フルパスからファイル名のみを抽出し、新しい文字列配列として取得しています。
`logFiles IsNot Nothing` のチェックは、ファイルが見つからなかった場合に `Directory.GetFiles` が空の配列を返すため、`Length > 0` と合わせて、配列が正常に生成されているか、かつ要素が存在するかを確認するために重要です。
4. ファイル・データベース連携における配列・リスト活用の注意点
ファイルやデータベースからデータを取得して配列やリストに格納する際、以下の点に注意が必要です。
- データ件数の確認: 取得したデータが空（0件）の場合、配列やリストが `Nothing` または空の状態で返されることがあります。ループ処理を行う前に、必ず件数を確認する処理を入れましょう。`If array IsNot Nothing AndAlso array.Length > 0 Then` や `If list IsNot Nothing AndAlso list.Count > 0 Then` のようなチェックが基本です。
- データ型の整合性: データベースから取得したデータや、ファイルから読み込んだデータは、予期せぬ型で返ってくることがあります。特に、NULL値の扱いや、数値・文字列の変換には細心の注意が必要です。`CInt()` や `CStr()` などの変換関数を使う際は、`IsDBNull()` や `Integer.TryParse()` などを併用して、エラーハンドリングを徹底しましょう。
- メモリ使用量: 大量のデータを配列やリストに一度に格納すると、メモリを大量に消費する可能性があります。特に、数万件以上のレコードを扱う場合は、バッチ処理やストリーミング処理を検討するなど、メモリ効率の良い設計を心がけてください。
5. まとめ：堅牢な設計のためのマインドセット
今回の配列宣言における「`New`」の省略とサイズ指定の罠は、VB.NET開発における、いわば「初心者の登竜門」のようなものです。しかし、これらの基本的な部分を疎かにしてしまうと、後々、原因究明に時間のかかる厄介なバグ、特に `NullReferenceException` に悩まされることになります。
「なぜこの書き方は非効率なのか」
それは、コードの意図が不明瞭になり、予期せぬエラーを引き起こす可能性を高めるからです。
「どう設計すべきか」
1. 明確な初期化: 配列やリストは、必ず `New` キーワード（または配列初期化子）を用いて、メモリ上に生成・初期化してから使用する。
2. 適切なサイズ指定: 配列のサイズ指定は、要素数ではなく最大インデックスを指定することを常に意識する。
3. 動的コレクションの活用: 要素数が不定な場合は、`List(Of T>` のような動的コレクションクラスを積極的に利用する。
4. 早期の件数チェック: ファイルやDBからデータを取得した後は、必ず件数を確認し、空の場合の処理を考慮する。
これらの原則を常に意識し、堅牢で保守性の高いコードを書き続けることが、皆さんの開発プロジェクトを成功に導く鍵となります。
本日の解説が、皆さんの日々の開発業務において、一つでも多くのバグを防ぎ、効率的なツール作成の一助となれば幸いです。
それでは、また次回の記事でお会いしましょう。
