メソッドを呼び出すときに名前付き引数を使うには？［C#／VB］：.NET TIPS

using static System.Console;
……省略……

// オプション引数に対応したメソッド
public static int SampleMethod1(int x=0, int y=0, int z=0)
  => x + y * 2 + z * 3;

……省略……

// 通常のメソッド呼び出し
WriteLine($"SampleMethod1(1,2,3)={SampleMethod1(1,2,3)}");
// 出力：SampleMethod1(1,2,3)=14

// 名前付き引数を使う
WriteLine($"SampleMethod1(x:1,y:2,z:3)={SampleMethod1(x:1,y:2,z:3)}");
// 出力：SampleMethod1(x:1,y:2,z:3)=14

// 引数の順序を変えられる
WriteLine($"SampleMethod1(z:3,x:1,y:2)={SampleMethod1(z:3,x:1,y:2)}");
// 出力：SampleMethod1(z:3,x:1,y:2)=14

// 呼び出すメソッドがオプション引数に対応しているなら、
// 必要な引数だけを任意の順序で与えられる
WriteLine($"SampleMethod1(z:3,x:1)={SampleMethod1(z:3,x:1)}");
// 出力：SampleMethod1(z:3,x:1)=10

// 後ろだけに名前引数を使う
WriteLine($"SampleMethod1(1,z:2,y:3)={SampleMethod1(1, z:2, y:3)}");
// 出力：SampleMethod1(1,z:2,y:3)=13

// 後ろに名前なしの通常の引数は使えない（コンパイル不可）
// WriteLine($"SampleMethod1(x:1,y:2,3)={SampleMethod1(x:1, y:2, 3)}");

// 引数名が違うとコンパイルできない
// WriteLine($"SampleMethod1(A:1,B:2,C:3)={SampleMethod1(A:1,B:2,C:3)}");
// すなわち、ライブラリ側で引数名を変えると、利用側でエラーが発生する

// 参照に、COMのタイプライブラリにある
//「Microsoft Excel xx.x Object Libray」（xx.xはバージョン番号）を追加する
// 冒頭に「using System.Runtime.InteropServices;」を追加する
// 冒頭に「using static System.Console;」を追加する
string sampleFile
  = System.IO.Path.Combine(Environment.CurrentDirectory, "Sample.xlsx");

// Excelを起動する
var excelApp = new Microsoft.Office.Interop.Excel.Application();
excelApp.Visible = true;

// 既存のファイル"Sample.xlsx"をワークブックに読み込む
var workbooks = excelApp.Workbooks;
// C# 4.0以前（名前付き引数とオプション引数が使えない）ではこう書くしかなかった
// var workbook = workbooks.Open(sampleFile, Type.Missing, true,
//   Type.Missing, "@password", Type.Missing, Type.Missing,
//   Type.Missing, Type.Missing, Type.Missing, Type.Missing,
//   Type.Missing, Type.Missing, Type.Missing, Type.Missing);

// 名前付き引数とオプション引数を使えば、シンプルに書ける
var workbook = workbooks.Open(sampleFile, ReadOnly: true, Password: "@password");

WriteLine("Excelファイルを読み取り専用で開きました");
WriteLine("何かキーを押すとExcelを閉じます");
ReadKey();

// 以下の解放処理は、本来は個別にtry〜finallyしなければならない
Marshal.ReleaseComObject(workbook);
Marshal.ReleaseComObject(workbooks);
excelApp.Quit(); Marshal.ReleaseComObject(excelApp);