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

C# 提供了一组整型和浮点数值类型。 任何两种数值类型之间都可以进行隐式或显式转换。 必须使用强制转换表达式来执行显式转换。

隐式数值转换

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

From	到
sbyte	short、int、long、float、double、decimal 或 nint。
byte	short、ushort、int、uint、long、ulong、float、double、decimal、nint 或 nuint
short	int、long、float、double、decimal 或 nint
ushort	int、uint、long、ulong、float、double、decimal、nint 或 nuint
int	long、float、double、decimal 或 nint
uint	long、ulong、float、double、decimal 或 nuint
long	float、double 或 decimal
ulong	float、double 或 decimal
float	double
nint	long、float、double 或 decimal
nuint	ulong、float、double 或 decimal

注意

从 int、uint、long、ulong、nint 或 nuint 到 float 的隐式转换以及从 long、ulong、nint 或 nuint 到 double 的隐式转换可能会丢失精准率，但绝不会丢失一个数量级。 其他隐式数值转换不会丢失任何信息。

另请注意

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

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

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

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

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

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

显式数值转换

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

From	到
sbyte	byte、ushort、uint、ulong 或 nuint
byte	sbyte
short	sbyte、byte、ushort、uint、ulong 或 nuint
ushort	sbyte、byte 或 short
int	sbyte、byte、short、ushort、uint、ulong 或 nuint。
uint	sbyte、byte、short、ushort、int 或 nint
long	sbyte、byte、short、ushort、int、uint、ulong、nint 或 nuint
ulong	sbyte、byte、short、ushort、int、uint、long、nint 或 nuint
float	sbyte、byte、short、ushort、int、uint、long、ulong、decimal、nint 或 nuint
double	sbyte、byte、short、ushort、int、uint、long、ulong、float、decimal、nint 或 nuint
decimal	sbyte、byte、short、ushort、int、uint、long、ulong、float、double、nint 或 nuint
nint	sbyte、byte、short、ushort、int、uint、ulong 或 nuint
nuint	sbyte、byte、short、ushort、int、uint、long 或 nint

注意

显式数值转换可能会导致数据丢失或引发异常，通常为 OverflowException。

另请注意：

• 将整数类型的值转换为另一个整数类型时，结果取决于溢出检查上下文。 在已检查的上下文中，如果源值在目标类型的范围内，则转换成功。 否则会引发 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# 语言规范的以下部分：

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

另请参阅

• 强制转换和类型转换