FormatException在C#中什么情况下抛出？如何预防？-C#.Net教程-PHP中文网

formatexception在c#中什么情况下抛出？如何预防？

FormatException

登录后复制

在C#中通常在你尝试将一个字符串转换成某种特定数据类型（比如数字、日期时间、布尔值等），但这个字符串的内容不符合该数据类型的预期格式时抛出。简单来说，就是你给定的文本“长得不像”目标类型该有的样子。

当我们在C#中进行数据类型转换，尤其是涉及到字符串解析时，

FormatException

登录后复制

是一个非常常见的运行时错误。它通常发生在以下几种情况：

数值类型转换： 尝试将一个包含非数字字符（如字母、特殊符号，或者不符合当前文化设置的小数点/千位分隔符）的字符串转换为
```
int
```
登录后复制
,
```
double
```
登录后复制
,
```
decimal
```
登录后复制
,
```
float
```
登录后复制
等数值类型时。比如，你试图把 "123a" 转换成
```
int
```
登录后复制
，或者把 "1,000.00" 在一个逗号是小数分隔符的文化环境下转换成
```
double
```
登录后复制
。
日期时间类型转换： 当你尝试将一个字符串解析为
```
DateTime
```
登录后复制
类型，但该字符串的格式与系统或指定的日期时间格式不匹配时。例如，
```
"2023-13-01"
```
登录后复制
（月份超出范围）或者
```
"January 1st, 2023"
```
登录后复制
在没有指定正确解析格式的情况下。
布尔类型转换：
```
bool.Parse()
```
登录后复制
方法只接受 "True" 或 "False" (不区分大小写) 作为有效输入。任何其他字符串，比如 "Yes", "No", "1", "0" 都会导致
```
FormatException
```
登录后复制
。
Guid
登录后复制
类型转换：
```
Guid.Parse()
```
登录后复制
要求输入的字符串必须是标准的GUID格式，例如
```
"{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}"
```
登录后复制
或
```
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```
登录后复制
。
Enum
登录后复制
类型转换：使用
```
Enum.Parse()
```
登录后复制
或
```
Enum.TryParse()
```
登录后复制
时，如果提供的字符串与枚举中定义的任何成员名称不匹配，或者与枚举的底层数值表示不符，也会抛出此异常。
string.Format
登录后复制
方法：虽然相对少见，但如果你在
```
string.Format
```
登录后复制
中使用了不正确的格式说明符（例如，尝试对非数字类型使用数字格式化），也可能引发
```
FormatException
```
登录后复制
。

如何有效避免C#中的FormatException？

在我看来，预防

FormatException

登录后复制

的核心思想是“先验证，后转换”或者“容错转换”。最直接且被广泛推荐的做法是使用各种数据类型提供的

TryParse

登录后复制

方法。

例如，当你需要将一个字符串转换为整数时，不要直接使用

int.Parse()

登录后复制

，而是选择

int.TryParse()

登录后复制

：

string input = "123";
int result;
if (int.TryParse(input, out result))
{
    Console.WriteLine($"转换成功：{result}");
}
else
{
    Console.WriteLine($"'{input}' 不是一个有效的整数格式。");
    // 这里可以处理错误，比如给用户提示，或者使用默认值
}

// 另一个例子，处理无效输入
string invalidInput = "abc";
if (int.TryParse(invalidInput, out result))
{
    Console.WriteLine($"转换成功：{result}");
}
else
{
    Console.WriteLine($"'{invalidInput}' 不是一个有效的整数格式。");
}

登录后复制

TryParse

登录后复制

方法的优势在于它不会抛出异常。如果转换成功，它返回

true

登录后复制

并将结果赋值给

out

登录后复制

参数；如果失败，它返回

false

登录后复制

，你可以根据返回值来决定后续的逻辑，避免程序崩溃。

对于日期时间，同样有

DateTime.TryParse()

登录后复制

和

DateTime.TryParseExact()

登录后复制

：

string dateString = "2023/08/15";
DateTime parsedDate;
if (DateTime.TryParse(dateString, out parsedDate))
{
    Console.WriteLine($"日期转换成功：{parsedDate.ToShortDateString()}");
}
else
{
    Console.WriteLine($"'{dateString}' 不是一个有效的日期格式。");
}

// 如果你知道确切的日期格式，使用 TryParseExact 更严谨
string exactDateString = "15-08-2023";
string format = "dd-MM-yyyy";
if (DateTime.TryParseExact(exactDateString, format, CultureInfo.InvariantCulture, DateTimeStyles.None, out parsedDate))
{
    Console.WriteLine($"精确日期转换成功：{parsedDate.ToShortDateString()}");
}
else
{
    Console.WriteLine($"'{exactDateString}' 不符合 '{format}' 格式。");
}

登录后复制

除了

TryParse

登录后复制

系列方法，还有一些辅助性的预防策略：

输入验证： 在尝试转换之前，对字符串进行初步检查。比如，使用正则表达式来确保字符串只包含数字，或者检查是否为空或
```
null
```
登录后复制
。
文化信息（
CultureInfo
登录后复制
）：当处理数字和日期时间时，明确指定
```
CultureInfo
```
登录后复制
可以避免因不同地区的小数点、千位分隔符或日期格式差异导致的
```
FormatException
```
登录后复制
。例如，
```
double.Parse("1.23", CultureInfo.InvariantCulture)
```
登录后复制
可以确保小数点是句点。
默认值： 在无法成功转换时，提供一个合理的默认值。

为什么数字字符串转换时常出现FormatException？

数字字符串转换是

FormatException

登录后复制

的重灾区，这背后其实有几个很实际的原因。我们平时输入数字，可能习惯了各种自由的格式，但计算机解析起来就没那么“聪明”了。

非数字字符的混入： 这是最常见的情况。用户可能不小心输入了字母（如 "123o"），或者一些特殊符号（如 "123$"），这些在
```
Parse
```
登录后复制
方法看来都是无法识别的“杂质”。想象一下，一个
```
int.Parse
```
登录后复制
方法，它期望的是纯粹的数字字符序列，遇到非数字就懵了。
空字符串或
null
登录后复制
：
```
int.Parse(null)
```
登录后复制
或者
```
int.Parse("")
```
登录后复制
都会直接抛出
```
ArgumentNullException
```
登录后复制
或
```
FormatException
```
登录后复制
。虽然
```
null
```
登录后复制
通常是
```
ArgumentNullException
```
登录后复制
，但空字符串对于
```
Parse
```
登录后复制
方法来说，也无法解析为任何有效的数字。
文化差异： 这点非常微妙但极其重要。不同的国家和地区，数字的表示方式可能不同。比如，在美国和英国，小数分隔符是句点（
```
.
```
登录后复制
），千位分隔符是逗号（
```
,
```
登录后复制
），如
```
1,234.56
```
登录后复制
。但在很多欧洲国家，小数分隔符是逗号（
```
,
```
登录后复制
），千位分隔符是句点（
```
.
```
登录后复制
），如
```
1.234,56
```
登录后复制
。如果你在一个使用逗号作为小数分隔符的系统上，尝试解析
```
"1,234.56"
```
登录后复制
这样的字符串（默认按当前文化解析），就会因为
```
.
```
登录后复制
被误认为是无效字符而抛出
```
FormatException
```
登录后复制
。反之亦然。
```
// 假设当前文化是en-US
double d1 = double.Parse("1,234.56"); // 成功，结果1234.56
// 假设当前文化是fr-FR (法国，逗号是小数分隔符)
// double d2 = double.Parse("1,234.56"); // 抛出FormatException，因为句点是无效字符
// 正确的做法是指定文化
double d3 = double.Parse("1.234,56", new CultureInfo("fr-FR")); // 成功，结果1234.56
```
登录后复制
数字溢出： 尝试将一个超出目标类型（如
```
int
```
登录后复制
的最大值
```
2,147,483,647
```
登录后复制
）表示范围的字符串转换时，会抛出
```
OverflowException
```
登录后复制
，而不是
```
FormatException
```
登录后复制
。但这两种异常都指向了输入字符串与目标类型不兼容的问题。
前导或尾随空格：
```
Parse
```
登录后复制
方法通常会忽略前导和尾随的空白字符，但如果字符串中间有空格，则会引发
```
FormatException
```
登录后复制
。例如，
```
int.Parse("12 3")
```
登录后复制
。

理解这些原因，就能更好地指导我们使用

TryParse

登录后复制

和

CultureInfo

登录后复制

来构建更健壮的转换逻辑。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

除了数字和日期，还有哪些常见的FormatException场景？

确实，

FormatException

登录后复制

不仅仅是数字和日期的“专属”。在处理其他类型的数据时，同样会遇到。这些情况虽然可能不如数字和日期转换那么频繁，但一旦出现，也同样令人头疼。

string.Format

登录后复制

的格式字符串错误： 这是我个人觉得比较隐蔽的一种。

string.Format

登录后复制

允许我们用占位符和格式说明符来格式化字符串。如果你提供的格式说明符与参数的类型不匹配，或者格式说明符本身就是无效的，就会抛出

FormatException

登录后复制

。

// 尝试将一个字符串用数字格式化
try
{
    string formattedString = string.Format("{0:N2}", "hello"); // 'N2' 是数字格式
    Console.WriteLine(formattedString);
}
catch (FormatException ex)
{
    Console.WriteLine($"string.Format 错误：{ex.Message}");
    // 输出：string.Format 错误：输入字符串的格式不正确。
}

// 错误的日期格式说明符
try
{
    DateTime now = DateTime.Now;
    string formattedDate = string.Format("{0:XYZ}", now); // 'XYZ' 是无效的日期格式
    Console.WriteLine(formattedDate);
}
catch (FormatException ex)
{
    Console.WriteLine($"string.Format 错误：{ex.Message}");
    // 输出：string.Format 错误：输入字符串的格式不正确。
}

登录后复制

这类错误往往发生在动态构建格式字符串或者复制粘贴时没有仔细检查。

Guid.Parse()

登录后复制

方法：

Guid

登录后复制

（全局唯一标识符）有其特定的字符串表示格式。如果你试图解析一个不符合这个格式的字符串，就会得到

FormatException

登录后复制

。标准的

Guid

登录后复制

字符串是32位十六进制数字，通常以连字符分隔成五个部分，或者带有大括号。

try
{
    Guid g1 = Guid.Parse("12345678-1234-1234-1234-1234567890AB"); // 正确
    Console.WriteLine($"Guid 转换成功：{g1}");

    Guid g2 = Guid.Parse("invalid-guid-string"); // 错误格式
    Console.WriteLine(g2);
}
catch (FormatException ex)
{
    Console.WriteLine($"Guid 转换错误：{ex.Message}");
    // 输出：Guid 转换错误：输入字符串的格式不正确。
}

登录后复制

和数字、日期一样，

Guid

登录后复制

也有

TryParse

登录后复制

方法，是更安全的做法。

Enum.Parse()

登录后复制

方法： 当你尝试将一个字符串转换为枚举类型时，如果该字符串不匹配任何枚举成员的名称（区分大小写，除非指定了

ignoreCase

登录后复制

参数），或者不匹配其底层数值，就会抛出

FormatException

登录后复制

。

public enum Status { Pending, Approved, Rejected }

try
{
    Status s1 = (Status)Enum.Parse(typeof(Status), "Approved"); // 正确
    Console.WriteLine($"枚举转换成功：{s1}");

    Status s2 = (Status)Enum.Parse(typeof(Status), "approved", true); // 忽略大小写
    Console.WriteLine($"枚举转换成功（忽略大小写）：{s2}");

    Status s3 = (Status)Enum.Parse(typeof(Status), "InvalidStatus"); // 错误
    Console.WriteLine(s3);
}
catch (FormatException ex)
{
    Console.WriteLine($"枚举转换错误：{ex.Message}");
    // 输出：枚举转换错误：请求的名称或值在枚举中找不到。
}

登录后复制

同样，