Checked (C# odniesienia)

checked Słowo kluczowe jest używany do jawnie włączyć sprawdzanie dla operacji arytmetycznych typu integralną i konwersje przepełnienie.

Domyślnie wyrażenie, które zawiera tylko wartości stałych powoduje wystąpienie błędu kompilatora, jeśli wyrażenie daje wartość, która jest spoza zakresu typu docelowego.Jeśli wyrażenie zawiera jedną lub więcej wartości-stała, kompilator nie może wykryć przeciążenia.Wyrażenie przypisywane do oceny i2 w następującym przykładzie nie spowoduje błąd kompilatora.

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

Domyślnie te wyrażenia-stała nie są sprawdzane dla przepełnienie w czasie wykonywania albo i nie powodują one wyjątki przepełnienie.Poprzedni przykład wyświetla-2,147,483,639 jako suma dwóch liczb całkowitych dodatnich.

Przepełnienie sprawdzania może być włączone przez opcje kompilatora, konfiguracji środowiska lub wykorzystania checked słowa kluczowego.Następujące przykłady przedstawiają sposób zastosowania checked wyrażenie lub checked bloku do wykrywania przepełnienia, który jest wytwarzany przez poprzednie Suma w czasie wykonywania.Przykłady zarówno wzbudzenie wyjątku przepełnienia.

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

Niesprawdzony można użyć słowa kluczowego, aby zapobiec sprawdzania przepełnienia.

Przykład

W przykładzie pokazano, jak użyć checked umożliwiające sprawdzanie w czasie wykonywania przepełnienie.

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

Specyfikacja języka C#

Aby uzyskać więcej informacji, zobacz Specyfikacja języka C#. Specyfikacja języka to najlepsze źródło informacji dotyczących składni i zastosowania języka C#.

Zobacz też

Informacje

Słowa kluczowe języka C#

Sprawdzane i niezaznaczone (C#)

jej źródłem jest niesprawdzony (C# odniesienia)

Koncepcje

Podręcznik programowania C#

Inne zasoby

C# odniesienia