محدد من (C# مرجع)

The checked كلمة أساسية هو used إلى بوضوح تمكين تجاوز يتم الآن التدقيق for integral-نوع arithmetic العمليات و conversions.

بشكل افتراضي، يؤدي تعبير الذي يحتوي على قيم ثابتة فقط خطأ المحول برمجي إذا أعطى التعبير قيمة التي هو خارج نطاق نوع وجهة. If the تعبير يحتوي على واحد أو المزيد non-ثابت قيم, the compiler does not detect the تجاوز. جاري الآن التقييم the تعبير تعيين إلى i2 في the following مثال does not cause a compiler خطأ.

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

بواسطة الافتراضي، هذه التعبيرات غير ثابت يتم غير محددة لتجاوز السعة في وقت التشغيل أما، فلا رفع استثناء تجاوز سعة. The السابق مثال displays -2,147,483,639 كـ the جمع of الثاني positive integers.

تجاوز يتم الآن التدقيق can be ممكّن بواسطة compiler خيارات, بيئة تكوين, أو استخدم of the checked كلمة أساسية. تبين الأمثلة التالية كيفية استخدام checkedالتعبير أو checkedكتلة للكشف عن تجاوز الحد الأقصى الذي يقدمه جمع السابق في وقت التشغيل. كلاهما أمثلة raise an تجاوز ‏‏ استثناء.

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

The غير محدد كلمة أساسية can be used إلى prevent تجاوز يتم الآن التدقيق.

مثال

This نموذج shows how إلى استخدم checked إلى تمكين تجاوز يتم الآن التدقيق at تشغيل الوقت.

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. مواصفات اللغة هي المصدر النهائي لبناء جملة C# واستخدامها.

راجع أيضًا:

المرجع

الكلمات الأساسية لـ #C

المفحوصة والغير مفحوصة (مرجع #C)

غير محدد ( مرجع C# )

المبادئ

دليل البرمجة لـ #C

موارد أخرى

مرجع C#‎