Windowsアプリ開発でよくあるエラーと解決方法まとめ【C#】

2024年10月12日2025年12月21日

WindowsアプリケーションやC#で開発をしていると、エラーに遭遇することは避けられません。初心者でも理解しやすいよう、エラーの原因と解決方法をわかりやすく説明しています。この記事が皆さんの開発の助けになれば幸いです！

1. エラー: 「Please set the ExcelPackage.LicenseContext property」

原因

EPPlusライブラリでExcelファイルを操作する際に、このエラーメッセージが表示されることがあります。これは、EPPlusが商用・非商用にかかわらずライセンスコンテキストの設定が必要になったことが原因です。

解決策

ライセンスコンテキストを設定することでこのエラーは解決できます。具体的には以下のコードを追加します。

ExcelPackage.LicenseContext = LicenseContext.NonCommercial;

このコードをExcelファイルを扱う処理の前に追加することで、EPPlusが非商用利用であることを明示できます。

2. エラー: 「現在のコンテキストに名前はない」

原因

「現在のコンテキストに名前はない」というエラーは、ClosedXMLやEPPlusなどでセルの範囲やシートを参照する際に発生します。このエラーは、セルやシートが見つからないか、ファイル内のデータが不完全であることが原因で起こります。

解決策

対象のシートやセルが正しく存在するか確認します。
ClosedXMLやEPPlusのメソッドを使用する際、必要に応じてnullチェックを追加しましょう。

例えば、データが存在するかチェックするコードは以下のようになります。

var worksheet = workbook.Worksheet(sheetIndex);
if (worksheet == null)
{
    MessageBox.Show("指定されたシートが存在しません。", "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
    return;
}

3. エラー: 「文字化け」

原因

CSVファイルやTSVファイルをShift-JISエンコードで扱わずに読み込むと、日本語の文字列が文字化けしてしまうことがあります。多くの日本語CSVはShift-JISエンコードで保存されているため、適切なエンコーディングで読み込むことが重要です。

解決策

CSVやTSVファイルを読み込むとき、Encoding.GetEncoding("Shift_JIS") を指定することで、Shift-JISエンコーディングを使用できます。

var lines = File.ReadAllLines(filePath, Encoding.GetEncoding("Shift_JIS"));

4. エラー: 開始行の処理が意図通りに動作しない

原因

データ間引き処理を開始する行が意図通りに設定されない場合は、データ行のスキップ方法や設定が間違っている可能性があります。また、データ行の開始位置が動的に決まるとき、ヘッダー行が特定できていないと、行がずれてしまいます。

解決策

ヘッダー行が固定ではなく、ユーザーが指定した行から開始するように numericUpDown の設定を反映させます。

例えば、numericUpDown_StartMabiki を使用するコードは以下の通りです。

int startRow = (int)numericUpDown_StartMabiki.Value - 1; // numericUpDown の値から開始行を取得
var dataLines = lines.Skip(startRow)
                     .Where(line => !string.IsNullOrWhiteSpace(line))
                     .ToList();

5. エラー: スキップ間隔が正しく反映されない

原因

間引き処理でスキップする間隔を指定しているにもかかわらず、実際の出力結果で設定した間隔にならないケースがあります。これは、スキップ間隔がnumericUpDown_SkipInterval の値から取得されていない、もしくは固定値が使用されていることが原因です。

解決策

スキップ間隔を numericUpDown_SkipInterval の値から取得するように修正します。

int skipInterval = (int)numericUpDown_SkipInterval.Value;
var filteredLines = dataLines.Where((line, index) => index % skipInterval == 0).ToList();

6. エラー: NumericUpDownの最大値を動的に設定する方法が分からない

原因

numericUpDown コントロールの最大値は、デフォルトでは固定されていますが、ファイルの行数や動的な条件に応じて最大値を設定する必要があります。

解決策

プロパティウィンドウで直接設定する方法もありますが、コードで設定する場合は、Maximum プロパティを使用します。

numericUpDown_StartMabiki.Maximum = lines.Length; // 行数を最大値に設定

まとめ

開発中によく発生するエラーと対策をまとめました。Windowsアプリケーションの開発において、特にEPPlusやClosedXMLを使ったファイル操作でのエラーや、文字化けなどの問題は多くの方が直面するかと思います。今回の対策が参考になれば幸いです。エラーが発生した際は、原因を分析して一つ一つ解決していきましょう。

なにかの参考になれば幸いです。

ここまで読んでいただきありがとうございました。