內建數值轉換 (C# 參考)

C# 提供一組 整數和浮點數值型別。 任何兩個數值型別之間存在一個轉換，可以是隱含或明確。 您必須使用轉換運算式來執行明確轉換。

隱含數值轉換

下表顯示內建數值型別間預先定義的隱含數值轉換：

從	至
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。

明確數值轉換

下表顯示內建數值型別間預先定義的明確轉換不含有隱含轉換：

從	至
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# 語言規格的下列幾節：

• 隱含數值轉換
• 明確數值轉換

另請參閱

• 轉換和類型轉換