checked (Riferimenti per C#)

La parola chiave checked viene utilizzata per abilitare in modo esplicito il controllo dell'overflow nelle conversioni e nelle operazioni aritmetiche di tipo integrale.

Per impostazione predefinita, un'espressione che contiene solo valori costanti provoca un errore del compilatore se produce un valore che non rientra nell'intervallo del tipo di destinazione. Se l'espressione contiene uno o più valori non costanti, l'overflow non viene rilevato dal compilatore. La valutazione dell'espressione assegnata a i2 nell'esempio seguente non provoca un errore del compilatore.

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

Per impostazione predefinita, in queste espressioni non costanti non viene eseguito il controllo dell'overflow nemmeno in fase di esecuzione e le espressioni non generano eccezioni di overflow. Nell'esempio precedente viene indicato il valore -2.147.483.639 come somma di due numeri interi positivi.

Il controllo dell'overflow può essere abilitato tramite le opzioni del compilatore, la configurazione dell'ambiente o l'utilizzo della parola chiave checked. Negli esempi seguenti viene illustrato come utilizzare un'espressione checked o un blocco checked per rilevare l'overflow prodotto in fase di esecuzione dalla somma precedente. Entrambi gli esempi generano un'eccezione di overflow.

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

La parola chiave unchecked può essere utilizzata per impedire il controllo dell'overflow.

Esempio

In questo esempio viene illustrato come utilizzare checked per abilitare il controllo dell'overflow in fase di esecuzione.

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

Specifiche del linguaggio C#

Per ulteriori informazioni, vedere la Specifiche del linguaggio C#. La specifica del linguaggio è la fonte ufficiale per la sintassi e l'utilizzo di C#.

Vedere anche

Riferimenti

Parole chiave di C#

Checked e Unchecked (Riferimenti per C#)

unchecked (Riferimenti per C#)

Concetti

Guida per programmatori C#

Altre risorse

Riferimenti per C#