C#のUInt32.MaxValueフィールドとは？使い方を実例付きで解説

C#におけるUInt32.MaxValueフィールドは、32ビット符号なし整数（uint型）が取り得る最大値を表す定数です。その値は「4294967295」であり、範囲チェックやデータ型変換など、さまざまな場面で活用できます。この記事では、UInt32.MaxValueの構文と具体的な使用例をわかりやすく紹介します。

構文

UInt32.MaxValueフィールドの構文は以下のとおりです。

public const uint MaxValue = 4294967295;

例1：UInt32.MaxValueの基本的な使い方

まずは、uint型の変数に対してハッシュコードの取得、等価比較、TypeCodeの確認を行い、最後にUInt32.MaxValueの値を出力する基本的な例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        uint val1 = 23;
        uint val2 = 0;
        Console.WriteLine("Value1 = "+val1);
        Console.WriteLine("Value2 = "+val2);
        Console.WriteLine("HashCode for value1 = "+val1.GetHashCode());
        Console.WriteLine("HashCode for value2 = "+val2.GetHashCode());
        Console.WriteLine("Are they equal? = "+(val1.Equals(val2)));
        TypeCode type1 = val1.GetTypeCode();
        TypeCode type2 = val2.GetTypeCode();
        Console.WriteLine("TypeCode for val1 = "+type1);
        Console.WriteLine("TypeCode for val2 = "+type2);
        Console.WriteLine("Maximum Value = "+ UInt32.MaxValue);
    }
}

出力結果

上記のコードを実行すると、次のような出力が得られます。

Value1 = 23
Value2 = 0
HashCode for value1 = 23
HashCode for value2 = 0
Are they equal? = False
TypeCode for val1 = UInt32
TypeCode for val2 = UInt32
Maximum Value = 4294967295

例2：範囲チェックにUInt32.MaxValueを活用する

次の例では、ulong型の配列の各要素がuint型の表現範囲（UInt32.MinValue〜UInt32.MaxValue）内に収まっているかどうかを判定し、範囲内であればConvert.ToUInt32メソッドを使ってuint型へ変換しています。このようにUInt32.MaxValueを使うことで、オーバーフローを防ぐ安全な変換処理を実現できます。

using System;
public class Demo {
    public static void Main(){
        ulong[]val = {568787, 8343443, 243434343};
        uint res;
        foreach(ulong a in val){
            if(a >= UInt32.MinValue && a <= UInt32.MaxValue){
                res = Convert.ToUInt32(a);
                Console.WriteLine("Converted: "+res);
            } else {
                Console.WriteLine("Not Possible");
            }
        }
    }
}

出力結果

上記のコードを実行すると、次のような出力が得られます。

Converted: 568787
Converted: 8343443
Converted: 243434343

まとめ

UInt32.MaxValueは、uint型が扱える最大値「4294967295」を表す定数です。値の範囲チェックや型変換の前段階での検証に利用することで、実行時エラーやオーバーフローを未然に防ぎ、より堅牢なC#プログラムを書くことができます。