こんにちは！開発現場で日々コードと格闘していると、「引数の数を柔軟に変えたい」「一部の引数は省略できるようにして、スッキリしたメソッドにしたい」という壁に必ずぶつかりますよね。
Excelのマクロ記録や、決まりきった処理を書くだけのステージから一歩抜け出し、「保守性が高く、誰が使ってもミスしない美しいメソッド設計」をしたい中級者の方へ向けて、今回はVB.NETの武器である`Optional`キーワードと`ParamArray`（パラメータ配列）の極意を伝授します。
ここをクリアすれば、あなたのVB.NETコードはワンランク上の「プロの設計」へと生まれ変わります。さあ、一緒に本質をマスターしていきましょう！
—
1. なぜ「引数の柔軟性」がメソッド設計の命運を分けるのか？
プログラムを書いていて、こんなモヤモヤを感じたことはありませんか？
- 「ログ出力用のメソッドを作ったけど、メッセージだけじゃなく『エラーレベル』も渡したい時がある。でも、大半は通常ログだから毎回書くのは面倒くさい……」
- 「複数の数値の合計を計算したいけど、引数の数が2個の時もあれば、5個の時もある。オーバーロード（多重定義）で何個もメソッドを作るのはダサい……」
こうした現場の悩みを鮮やかに解決してくれるのが、今回解説する`Optional`（省略可能引数）と`ParamArray`（可変長引数）です。
それぞれの特徴と、使い分けの境界線をしっかり見ていきましょう。
—
2. `Optional` キーワード：決まりきったデフォルト値で引数を省略する
まずは`Optional`です。これは、「呼び出し側が値を渡さなかった場合に備えて、あらかじめデフォルト値（既定値）を用意しておく」ための機能です。
基本的な書き方とコード例
例えば、ユーザーに挨拶をするメソッドを考えてみましょう。「名前」は必須ですが、「敬称」は省略できるようにしたい場合、以下のように書きます。
Public Sub Greet(ByVal name As String, Optional ByVal title As String “様”)
Console.WriteLine($”こんにちは、{name} {title}！”)
End Sub
呼び出し側の世界
このメソッドは、以下のように2通りの方法で呼び出せます。
‘ 1. 敬称を省略する（デフォルトの「様」が使われる）
Greet(“山田”) ‘ 出力: こんにちは、山田 様！
‘ 2. 敬称を明示的に指定する
Greet(“田中”, “部長”) ‘ 出力: こんにちは、田中 部長！
⚠️ ここに注意！`Optional`の鉄則
`Optional`を使うときは、「省略可能な引数は、必ずすべての必須引数の後ろ（右側）に配置しなければならない」というVB.NETの厳格なルールがあります。
- NG例: `Sub Test(Optional ByVal x As Integer = 0, ByVal y As Integer)`
（左側に省略可能なものがあると、右側の`y`を省略していいのか判断がつかなくなるため、コンパイルエラーになります）
- OK例: `Sub Test(ByVal y As Integer, Optional ByVal x As Integer = 0)`
—
3. `ParamArray`（パラメータ配列）：無限の引数をスマートに飲み込む
次に、引数の数が固定されていないケースです。「いくつ渡されるか分からない数値を、まとめて配列として受け取りたい！」という時に使うのが`ParamArray`です。
基本的な書き方とコード例
任意の個数の整数を受け取り、その総和を計算するメソッドを作ってみましょう。
Public Function CalculateSum(ByVal ParamArray numbers As Integer()) As Integer
Dim sum As Integer = 0
‘ 受け取った引数は、内部ではただの「配列」として扱える！
For Each n As Integer In numbers
sum += n
Next
Return sum
End Function
呼び出し側の世界
呼び出す側は、カンマ区切りで好きなだけ引数を並べることができます。配列のインスタンスをわざわざ生成して渡す必要すらありません。
Dim result1 As Integer = CalculateSum(10, 20) ‘ 引数2つ（合計: 30）
Dim result2 As Integer = CalculateSum(5, 10, 15, 20, 25) ‘ 引数5つ（合計: 75）
Dim result3 As Integer = CalculateSum() ‘ 引数0個でもエラーにならない（合計: 0）
非常にスマートですよね。マクロや従来のVBAで散見された「引数をVariant型の配列で受けてゴニョゴニョ判定する」という泥臭いコードとはおさらばです。型安全性を保ったまま、可変長引数を扱えるのがVB.NETの強みです。
⚠️ ここに注意！`ParamArray`の鉄則
1. メソッド内で最後の引数でなければならない: `Optional`と同様、`ParamArray`も引数リストの一番右側に配置する必要があります。
2. ByValでなければならない: `ParamArray`の前には必ず`ByVal`を指定します（`ByRef`は指定できません）。
—
4. どっちを使うべき？現場で迷った時の判断基準
「省略したい」のか、「いくつあるか分からない」のか、ここを取り違えると保守性の低いコードになってしまいます。以下の基準で使い分けましょう。
| 特徴 | `Optional` (省略可能引数) | `ParamArray` (パラメータ配列) |
| :— | :— | :— |
| 引数の数 | 最大でメソッド定義通りの数（一部を省略可能） | 0個から無制限（いくつでもOK） |
| 主な用途 | 設定値のデフォルト補完、フラグの切り替えなど | ログ出力、一括データ処理、SQLのパラメータ構築など |
| 型の一致 | 個々の引数ごとに異なる型を指定可能 | すべて同じ型（または共通の親クラス型）に統一される |
- 「1個か2個のオプション項目がある」なら `Optional`
- 「同じ種類のデータがいくつ飛んでくるか分からない」なら `ParamArray`
—
5. 実務で役立つ！実践的メソッド設計パターン
最後に、これらを組み合わせた、現場で即座に使える「ちょっとリッチなログ出力メソッド」のサンプルコードをご紹介します。
Public Class Logger
‘ メッセージは必須、ログレベルとタグは省略可能。さらに複数の付加データをParamArrayで受け取る
Public Sub WriteLog(ByVal message As String,
Optional ByVal logLevel As String = “INFO”,
Optional ByVal tag As String = “GENERAL”,
ParamArray ByVal details As String())
‘ タイムスタンプやヘッダーの構築
Dim logHeader As String = $”[{DateTime.Now:yyyy-MM-dd HH:mm:ss}] [{logLevel}] ({tag}):”
Console.WriteLine($”{logHeader} {message}”)
‘ 付加データがあれば出力する
If details.Length > 0 Then
Console.WriteLine(” — Details —“)
For Each detail As String In details
Console.WriteLine($” – {detail}”)
Next
End If
End Sub
End Class
呼び出し例のバリエーション
このメソッドは、設計が洗練されているため、呼び出し側が非常に直感的に記述できます。
Dim logger As New Logger()
‘ 1. 最低限の情報だけで呼ぶ (Optionalのデフォルト値が自動適用される)
logger.WriteLog(“システムを起動しました。”)
‘ 2. ログレベルとタグを指定する
logger.WriteLog(“データベースに接続しました。”, “DEBUG”, “DB_MODULE”)
‘ 3. さらに詳細なエラー情報（可変長）をぶら下げる！
logger.WriteLog(“トランザクションがロールバックされました。”, “ERROR”, “PAYMENT”, “ユーザーID: 12345”, “金額: 50,000円”, “理由: タイムアウト”)
—
まとめ
ここをクリアすれば、Visual Basic (VB / VB.NET)のメソッド設計の基本はもうバッチリです！
- `Optional` で、冗長なオーバーロードを減らし、デフォルト値でコードをシンプルに保つ。
- `ParamArray` で、型安全性を維持したまま、柔軟な可変長引数をスマートにさばく。
この2つの武器を適切にコードへ取り入れることで、あなた自身が後から見直した時も、他のチームメンバーが保守する時も、愛される美しいコードが書けるようになります。
ぜひ、日々の開発やツール作成に役立ててみてくださいね。応援しています！
