kontrolované (C#-Reference)

checked Explicitně povolit přetečení kontrolu integrál typu aritmetické operace a převody se používá klíčové slovo.

Ve výchozím nastavení výraz, který obsahuje pouze konstantní hodnoty způsobí v kompilátoru chybu Pokud výraz hodnotu, která je mimo rozsah typu místa určení.Pokud výraz obsahuje jednu nebo více hodnot není konstantní, kompilátor nezjistí přetečení.Výraz přiřazen k i2 v následujícím příkladu nezpůsobuje chyby kompilátoru.

// 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);

Ve výchozím nastavení tyto výrazy-constant nejsou kontrolovány pro přetečení v době spuštění buď a nevyvolávají výjimky přetečení.Předchozí příklad zobrazuje-2,147,483,639 jako součet dvou kladná celá čísla.

Kontrolu přetečení může povolit možnosti kompilátoru, konfigurace prostředí nebo použití checked klíčové slovo.Následující příklady ukazují způsob použití checked výraz nebo checked bloku zjistit přetečení předchozího součet vyrobené v době spuštění.Oba příklady vyvolat výjimku přetečení.

// 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);
}

Nekontrolovaná klíčové slovo lze zabránit kontrole přetečení.

Příklad

Tento příklad ukazuje použití checked povolit kontrolu v době spuštění přetečení.

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
 */
}

Specifikace jazyka C#

Další informace naleznete v tématu Specifikace jazyka C#. Specifikace jazyka je úplným a rozhodujícím zdrojem pro syntaxi a použití jazyka C#.

Viz také

Referenční dokumentace

Klíčová slova jazyka C#

Kontrolovány a nekontrolované (C#-Reference)

Nekontrolovaná (C#-Reference)

Koncepty

Příručka programování C#

Další zdroje

C#-Reference