C# ‘System.FormatException: Input string was not in a correct format.’ の原因と解決方法

System.FormatException: Input string was not in a correct format. とは

このエラーは、文字列を異なるデータ型（整数、日付、浮動小数点数など）に変換しようとした際に、その文字列が変換先の型として有効な形式ではない場合に発生します。ユーザー入力やファイルからのデータ読み込みで頻繁に見られる一般的なエラーです。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: 非数値文字列を整数に変換

string input = "abc";
int number = int.Parse(input); // System.FormatException: Input string was not in a correct format.

“abc”は有効な整数形式ではないため、int.Parse()メソッドでint型に変換しようとするとFormatExceptionが発生します。変換前に文字列の内容を検証する必要があります。

string input = "abc";
int number;
if (int.TryParse(input, out number))
{
    Console.WriteLine($"Parsed number: {number}");
}
else
{
    Console.WriteLine("Invalid input for number.");
}

パターン2: 無効な日付形式の文字列を日付に変換

string dateString = "2023-13-01"; // 13月は無効
DateTime date = DateTime.Parse(dateString); // System.FormatException: String was not recognized as a valid DateTime.

“2023-13-01″は月が13であり、有効な日付形式ではありません。DateTime.Parse()は厳密な日付形式を期待するため、この形式ではエラーになります。

string dateString = "2023-13-01";
DateTime date;
if (DateTime.TryParse(dateString, out date))
{
    Console.WriteLine($"Parsed date: {date}");
}
else
{
    Console.WriteLine("Invalid input for date.");
}

パターン3: ToString()やstring.Format()での不適切なフォーマット指定子

double value = 123.45;
string formatted = value.ToString("X"); // System.FormatException: Format String can be only "G", "g", "C", "c", "D", "d", "E", "e", "F", "f", "N", "n", "P", "p", "R", "r", "X", "x".

double型には16進数形式指定子"X"が適用できないため、ToString("X")を使用するとFormatExceptionが発生します。適切なフォーマット指定子を使用する必要があります。

double value = 123.45;
string formatted = value.ToString("F2"); // "123.45" (F2は小数点以下2桁の浮動小数点数)
Console.WriteLine(formatted);

根本原因の特定方法

エラーが発生したParse系のメソッド呼び出しの直前で、入力文字列の値をデバッガで確認してください。その文字列が期待する形式と合致しているかを注意深くチェックします。

string problematicString = "Hello"; // 例として不正な文字列

// デバッガでproblematicStringの値を確認
if (int.TryParse(problematicString, out int result))
{
    Console.WriteLine("Success: " + result);
}
else
{
    Console.WriteLine("Failed to parse: " + problematicString);
}

防止策とベストプラクティス

Parseメソッドの代わりに、TryParseメソッドやConvert.ChangeTypeメソッドを使用し、例外処理(try-catchブロック)を適切に実装することで、予期せぬFormatExceptionを防ぐことができます。

string input = "123a"; // 不正な入力

try
{
    int number = int.Parse(input); // ここでFormatExceptionが発生
    Console.WriteLine(number);
}
catch (FormatException ex)
{
    Console.WriteLine("Error: Input string was not in a correct format. " + ex.Message);
}
catch (OverflowException ex)
{
    Console.WriteLine("Error: Number was too large or too small. " + ex.Message);
}

よくある質問（FAQ）