checked (C# リファレンス)checked (C# Reference)

checked キーワードは、整数型の算術演算と変換に対してオーバーフロー チェックを明示的に有効にするために使用します。The checked keyword is used to explicitly enable overflow checking for integral-type arithmetic operations and conversions.

既定では、定数値のみを含む式がチェック先の型の範囲外にある値を生成した場合、コンパイラ エラーが発生します。By default, an expression that contains only constant values causes a compiler error if the expression produces a value that is outside the range of the destination type. 式が 1 つ以上の非定数値を含む場合、コンパイラはオーバーフローを検出しません。If the expression contains one or more non-constant values, the compiler does not detect the overflow. 次の例で i2 に割り当てられた式を評価しても、コンパイラ エラーは発生しません。Evaluating the expression assigned to i2 in the following example does not cause a compiler error.

// The following example causes compiler error CS0220 because 2147483647
// is the maximum value for integers. 
//int i1 = 2147483647 + 10;

// The following example, which includes variable ten, does not cause
// a compiler error.
int ten = 10;
int i2 = 2147483647 + ten;

// By default, the overflow in the previous statement also does
// not cause a run-time exception. The following line displays 
// -2,147,483,639 as the sum of 2,147,483,647 and 10.
Console.WriteLine(i2);

既定では、これらの非定数式のオーバーフローは実行時にもチェックされず、オーバーフロー例外も発生しません。By default, these non-constant expressions are not checked for overflow at run time either, and they do not raise overflow exceptions. 前の例では、2 つの正の整数の合計として -2,147,483,639 が表示されます。The previous example displays -2,147,483,639 as the sum of two positive integers.

オーバーフロー チェックを有効にするには、コンパイラ オプション、環境設定、または checked キーワードを使用します。Overflow checking can be enabled by compiler options, environment configuration, or use of the checked keyword. checked 式または checked ブロックを使用して、前の合計によって生じたオーバーフローを実行時に検出する方法を次の例に示します。The following examples demonstrate how to use a checked expression or a checked block to detect the overflow that is produced by the previous sum at run time. どちらの例でもオーバーフロー例外が発生します。Both examples raise an overflow exception.

// If the previous sum is attempted in a checked environment, an 
// OverflowException error is raised.

// Checked expression.
Console.WriteLine(checked(2147483647 + ten));

// Checked block.
checked
{
    int i3 = 2147483647 + ten;
    Console.WriteLine(i3);
}

unchecked キーワードを使用してオーバーフロー チェックを行わないようにすることもできます。The unchecked keyword can be used to prevent overflow checking.

Example

この例では、checked を使用して実行時のオーバーフロー チェックを有効にする方法を示します。This sample shows how to use checked to enable overflow checking at run time.

class OverFlowTest
{
    // Set maxIntValue to the maximum value for integers.
    static int maxIntValue = 2147483647;

    // Using a checked expression.
    static int CheckedMethod()
    {
        int z = 0;
        try
        {
            // The following line raises an exception because it is checked.
            z = checked(maxIntValue + 10);
        }
        catch (System.OverflowException e)
        {
            // The following line displays information about the error.
            Console.WriteLine("CHECKED and CAUGHT:  " + e.ToString());
        }
        // The value of z is still 0.
        return z;
    }

    // Using an unchecked expression.
    static int UncheckedMethod()
    {
        int z = 0;
        try
        {
            // The following calculation is unchecked and will not 
            // raise an exception.
            z = maxIntValue + 10;
        }
        catch (System.OverflowException e)
        {
            // The following line will not be executed.
            Console.WriteLine("UNCHECKED and CAUGHT:  " + e.ToString());
        }
        // Because of the undetected overflow, the sum of 2147483647 + 10 is 
        // returned as -2147483639.
        return z;
    }

    static void Main()
    {
        Console.WriteLine("\nCHECKED output value is: {0}",
                          CheckedMethod());
        Console.WriteLine("UNCHECKED output value is: {0}",
                          UncheckedMethod());
    }
    /*
   Output:
   CHECKED and CAUGHT:  System.OverflowException: Arithmetic operation resulted
   in an overflow.
      at ConsoleApplication1.OverFlowTest.CheckedMethod() 

   CHECKED output value is: 0
   UNCHECKED output value is: -2147483639
 */
}

C# 言語仕様C# language specification

詳細については、「C# 言語の仕様」を参照してください。For more information, see the C# Language Specification. 言語仕様は、C# の構文と使用法に関する信頼性のある情報源です。The language specification is the definitive source for C# syntax and usage.

関連項目See also

C# リファレンスC# Reference
C# プログラミング ガイドC# Programming Guide
C# のキーワードC# Keywords
Checked と UncheckedChecked and Unchecked
uncheckedunchecked