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

C#におけるUInt16.MaxValueフィールドは、16ビット符号なし整数（ushort型）が取り得る最大値を表す定数です。値の範囲チェックや変換処理などで頻繁に活用されます。

構文

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

public const ushort MaxValue = 65535;

このように、MaxValueは定数（const）として定義されており、その値は常に65535です。ushort型は0〜65535の範囲の値を扱えるため、最大値が65535となります。

使用例1：基本的なプロパティの確認

まず、UInt16.MaxValueフィールドを使った基本的な実装例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        ushort val1 = 23;
        ushort 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 = "+ UInt16.MaxValue);
    }
}

出力結果

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

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

この例では、2つのushort型変数のハッシュコード、等価性、TypeCodeを確認し、最後にUInt16.MaxValueの値（65535）を出力しています。

使用例2：値の範囲チェックと変換

続いて、UInt16.MinValueとUInt16.MaxValueを組み合わせて、値がushort型の範囲内に収まっているかを判定する実践的な例を紹介します。

using System;
public class Demo {
    public static void Main(){
        ulong[]val = {8998, 899898778, 878787878};
        ushort res;
        foreach(ulong a in val){
            if(a >= UInt16.MinValue && a <= UInt16.MaxValue){
                res = Convert.ToUInt16(a);
                Console.WriteLine("Converted: "+res);
            } else {
                Console.WriteLine("Not Possible");
            }
        }
    }
}

出力結果

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

Converted: 8998
Not Possible
Not Possible

この例では、ulong型の配列に格納された各値について、UInt16.MinValue（0）以上かつUInt16.MaxValue（65535）以下であるかを判定しています。範囲内の値のみConvert.ToUInt16メソッドで変換され、範囲外の大きな値は「Not Possible」と表示されます。

まとめ

UInt16.MaxValueフィールドは、ushort型の上限値65535を返す便利な定数です。値の範囲バリデーションや安全な型変換の前チェックなど、数値処理において幅広く活用できます。同様に、最小値を取得したい場合はUInt16.MinValueを使用します。