CS0～400

C# コンパイラエラー CS0031の原因と対策を解説

2025-03-29更新日: 2025-03-29

CS0031は、C#で定数値を特定の型に変換できない場合に発生するコンパイルエラーです。

たとえば、2147483648Mのような数値をint型にキャストすると、値が収まらずエラーとなります。

エラーが発生した際は、使用する型やリテラルの範囲を見直してください。

目次から探す

エラーの原因
- 定数リテラルと型の不整合
- キャスト操作時の問題点
発生例の検証
- 数値リテラル使用時のエラー
- unchecked コンテキストでのエラー発生
解決方法の具体例
- 適切な型選定による対処
- キャスト処理の見直しポイント
型変換基本ルールの確認
- 定数と変数の取り扱い
- 型変換ルールの再確認
まとめ

エラーの原因

定数リテラルと型の不整合

C# のコンパイラエラー CS0031 は、定数リテラルの値が対象となる型の許容範囲を超えている場合に発生します。

例えば、int型の最大値は

$2^{31} - 1 = 2147483647$

ですが、これを超える数値リテラル(例：2147483648M)に対して明示的なキャストを行うと、範囲外の値を変換しようとするためエラーが発生します。

定数リテラルはコンパイル時にその値が評価されるため、変数と異なり実行時チェックに頼ることができず、コンパイル時に厳密な範囲チェックが実施されます。

キャスト操作時の問題点

明示的なキャストは、通常、ある型から別の型に変換する手段として用いられます。

しかし、定数リテラルで行うキャストの場合、その値がコンパイル時に評価されるため、値が変換先の型に収まらなければエラーとなります。

また、キャストにより暗黙の型変換ルールが適用されないため、開発者が変換後の値が正しく表現可能かどうか注意深く確認する必要があります。

発生例の検証

数値リテラル使用時のエラー

int 型への不適切な変換事例

次のサンプルコードは、decimal型の定数リテラル 2147483648M を int型にキャストしようとした例です。

この値は、int型が扱える最大値 $, 2147483647,$ を超えているため、コンパイル時にエラー CS0031 が発生します。

using System;
namespace CS0031Example
{
    public class Program
    {
        public static void Main()
        {
            // 2147483648 は int の最大値 2147483647 を超えているのでエラーが発生する例です
            int num = (int)2147483648M;  // コンパイラ エラー CS0031 が発生
            Console.WriteLine(num);
        }
    }
}

// コンパイルエラー: 定数 '2147483648' を型 'int' に変換できません。 (CS0031)

unchecked コンテキストでのエラー発生

const 宣言における型変換の失敗

const 宣言では、値がコンパイル時に固定されるため、unchecked コンテキスト内であってもキャストにより発生するエラーは回避できません。

以下のコードは、decimal型の定数値を byte型にキャストした例です。

値が byte型で表現できる範囲 ( $0 \sim 255$ ) を外れていると、コンパイルエラーが発生します。

using System;
namespace CS0031UncheckedExample
{
    public class Program
    {
        public static void Main()
        {
            const decimal d = -10M;  // マイナス値の例
            unchecked
            {
                // -10 は byte 型の表現範囲に含まれないためエラーが発生します
                const byte b = (byte)d;  // コンパイラ エラー CS0031
                Console.WriteLine(b);
            }
        }
    }
}

// コンパイルエラー: 定数 '-10' を型 'byte' に変換できません。 (CS0031)

解決方法の具体例

適切な型選定による対処

大数値に対する型変更事例

数値リテラルの値が現在使用している型の範囲を超えている場合、より大きな型に変更することでエラーを回避できます。

たとえば、2147483648M のような大きな値の場合、int ではなく long型にキャストすることで、数値を正しく扱うことができます。

以下のサンプルコードはその例です。

using System;
namespace CS0031SolutionExample
{
    public class Program
    {
        public static void Main()
        {
            // int 型から long 型に変更することで、2147483648 を正しく扱えるようにします
            long num = (long)2147483648M;
            Console.WriteLine("変換成功: " + num);
        }
    }
}

変換成功: 2147483648

キャスト処理の見直しポイント

キャストを行う際は、対象の値が変換先の型の表現範囲内に収まっているかどうかを事前に確認することが重要です。

定数リテラルの場合、コンパイル時の評価により変換エラーが発生するため、次の点に注意してください。

定数の範囲がキャスト先の型の範囲(例えば、int の場合は $, - 2147483648 \sim 2147483647,$ )に収まっているか確認する。
もし範囲外であれば、より大きな型(例：long や decimal)を検討する。
必要な場合は、キャスト前に値が正しいかどうかを条件分岐でチェックして、エラーを未然に防ぐ設計も有効です。

型変換基本ルールの確認

定数と変数の取り扱い

C# では、const キーワードで宣言された値はコンパイル時に決定されるため、型変換もその段階で行われます。

一方、変数は実行時に値が決まるため、同じキャスト処理でもコンパイルエラーには至らない場合があります。

定数の場合は、値が厳格にチェックされ、問題があればコンパイル時にエラーとして検出される点を理解してください。

型変換ルールの再確認

型変換においては、変換先の型が許容する値の範囲を事前に把握することが基本です。

具体的には、ある型から別の型に変換する際は、 $, x \in [min, max],$ の範囲内であるかどうかが重要です。

範囲外の値の場合、コンパイラはエラー CS0031 を報告します。

また、明示的なキャストが要求される場合でも、変換後の値が正しく表現されるかを十分に検討することが、安定したコードを書く上での鍵となります。

まとめ

この記事では、C#のコンパイラエラーCS0031の原因と対策として、定数リテラルが対象型の範囲外である場合や、キャスト操作時に発生する問題点を解説しています。

数値リテラルの不適切な変換事例や、uncheckedコンテキストでの定数キャストの失敗例を実例と共に示し、適切な型選定やキャスト処理の見直しの手法を具体的に説明しています。

定数と変数の違いも再確認でき、安定した型変換の基本が理解できます。