内置数值转换（C# 参考）

• 2019/10/22

C# 提供了一组整型和浮点数值类型。 任何两种数值类型之间都可以进行隐式或显式转换。 必须使用强制转换运算符 () 才能调用显式转换。

隐式数值转换

下表显示内置数值类型之间的预定义隐式转换：

另请注意

• 任何整型数值类型都可以隐式转换为任何浮点数值类型。

• 不存在针对 byte 和 sbyte 类型的隐式转换。 不存在从 double 和 decimal 类型的隐式转换。

• decimal 类型和 float 或 double 类型之间不存在隐式转换。

• 类型 int 的常量表达式的值（例如，由整数文本所表示的值）如果在目标类型的范围内，则可隐式转换为 sbyte、byte、short、ushort、uint 或 ulong：

  C#复制

  byte a = 13;
  byte b = 300;  // CS0031: Constant value ‘300‘ cannot be converted to a ‘byte‘

   

  如前面的示例所示，如果该常量值不在目标类型的范围内，则发生编译器错误 CS0031。

显式数值转换

下表显示不存在隐式转换的内置数值类型之间的预定义显式转换：

另请注意

• 将整数类型的值转换为另一个整数类型时，结果取决于溢出检查上下文。 在已检查的上下文中，如果源值在目标类型的范围内，则转换成功。 否则会引发 OverflowException。 在未检查的上下文中，转换始终成功，并按如下方式进行：

  • 如果源类型大于目标类型，则通过放弃其“额外”最高有效位来截断源值。 结果会被视为目标类型的值。

  • 如果源类型小于目标类型，则源值是符号扩展或零扩展，以使其与目标类型的大小相同。 如果源类型带符号，则是符号扩展；如果源类型是无符号的，则是零扩展。 结果会被视为目标类型的值。

  • 如果源类型与目标类型的大小相同，则源值将被视为目标类型的值。

• 将 decimal 值转换为整型类型时，此值会向零舍入到最接近的整数值。 如果生成的整数值处于目标类型的范围之外，则会引发 OverflowException。

• 将 double 或 float 值转换为整型类型时，此值会向零舍入到最接近的整数值。 如果生成的整数值处于目标类型范围之外，则结果会取决于溢出上下文。 在已检查的上下文中，引发 OverflowException；而在未检查的上下文中，结果是目标类型的未指定值。

• 将 double 转换为 float 时，double 值舍入为最接近的 float 值。 如果 double 值太小或太大，无法匹配 float 类型，结果将为零或无穷大。

• 将 float 或 double 转换为 decimal 时，源值转换为 decimal 表示形式，并并五入到第 28 位小数后最接近的数（如果需要）。 根据源值的值，可能出现以下结果之一：

  • 如果源值太小，无法表示为 decimal，结果则为零。

  • 如果源值为 NaN（非数值）、无穷大或太大而无法表示为 decimal，则引发 OverflowException。

• 将 decimal 转换为 float 或 double 时，源值分别舍入为最接近的 float 或 double 值。

C# 语言规范

有关更多信息，请参阅 C# 语言规范的以下部分：

• 隐式数值转换
• 显式数值转换

请参阅

• C# 参考
• 强制转换和类型转换