تكوين التحذيرات في Visual Basic

مقالة
11/01/2010

برنامج التحويل البرمجي Visual Basic يتضمن مجموعة من التحذيرات حول التعليمات البرمجية التي قد تتسبب في أخطاء وقت التشغيل. يمكنك استخدام هذه المعلومات لكتابة أنظف ، و أسرع، و تعليمات برمجية أفضل مع أخطاء أقل. و على سبيل المثال، ينتج المحول البرمجي تحذير عند محاولة المستخدم استدعاء عضو في متغير كائن غير معين أو محاولة إرجاع دالة بدون إعداد القيمة المرجعة, أو تنفيذ كتلة Try مع وجود خطأ في المنطق لجذب الاستثناءات.

في بعض الأحيان يوفر المحول البرمجي منطق إضافي نيابة عن المستخدم بحيث يمكن للمستخدم التركيز على مهمة الحالية بدلاً من توقع الأخطاء الممكنة. في الإصدارات السابقة من Visual Basic, تم استخدام Option Strict لتحديد منطق إضافي يوفره برنامج التحويل البرمجي Visual Basic . تكوين تحذيرات يسمح بتحديد المنطق بطريقة محببة أكثر من مستوى التحذيرات الفردية.

قد تحتاج لتخصيص المشروع و إيقاف تشغيل بعض التحذيرات غير المتعلقة بالتطبيق الخاص بك أثناء تحويل تحذيرات أخرى إلى أخطاء. هذه الصفحة توضح كيفية تشغيل التحذيرات الفردية و إيقافها .

تشغيل و إيقاف تشغيل التحذيرات

توجد طريقتان مختلفتان لتكوين التحذيرات: يمكنك تكوينهم باستخدام مصمم مشروع ، او يمكنك استخدام خيارات برنامج التحويل البرمجي /warnaserror و /nowarn .

علامة التبويب حول برمجياً لصفحة مصمم المشروع تسمح لك بتشغيل التحذيرات و إيقاف تشغيلها. حدد خانة اختيار عطل كل التحذيرات لتعطيل كل التحذيرات; حدد معاملة كل التحذيرات كأخطاء لمعاملة كل التحذيرات كأخطاء. بعض التحذيرات الفردية يمكن تثبيتها كخطأ أو تحذير مطلوب كما هو موضح في الجدول المعروض.

عند تعيين خيار صارم إلى إيقاف, فإن التحذيرات المتعلقة بـ الخيار الصارم لا يتم معاملتها بشكل مستقل عن بعضها البعض. عند تعيين الخيار الصارم إلى تشغيل فإن التحذيرات المقترنة تُعامل على أنها أخطاء ، بغض النظر عن ما حالتها. عند تعيين الخيار الصارم إلى مخصص بوساطة تحديد /optionstrict:custom في مترجم خط الأوامر ، فإن تحذيرات الخيار الصارم يمكن تبديلها عند النقر مرة لتشغيلها أو إيقاف تشغيلها بشكل مستقل.

خيار خط الأوامر /warnaserror للمحول البرمجي يمكن استخدامه أيضاً لتحديد ما إذا كانت التحذيرات تُعامل على أنها أخطاء. يمكنك إضافة قائمة بالفواصل إلى هذا الخيار لتحديد أي التحذيرات يجب أن تتم معاملتها على أنها أخطاء أو تحذيرات باستخدام + أو -. يوضح الجدول التالي الخيارات الممكنة.

خيار سطر الأوامر	تحدد .
/warnaserror+	معاملة كل التحذيرات كأخطاء.
/warnsaserror-	لا تعامل التحذيرات كأخطاء. هذا هو الإعداد الافتراضي.
/warnaserror+:<warning list>	معاملة التحذيرات المعينة كأخطاء ، مسرودة بواسطة رقم هوية الخطأ في قائمة الفواصل المحددة r .
/warnaserror-:<warning list>	لا تٌعامل التحذيرات المعينة كأخطاء ، مسرودة بواسطة رقم هوية الخطأ في قائمة الفواصل المحددة .
/nowarn	لا ترسل تقرير بالتحذيرات.
/nowarn:<warning list>	عدم الإعلام عن التحذيرات المحددة المسرودة بواسطة رقم هوية الخطأ في قائمة الفواصل المحددة .

تحتوي قائمة التحذيرات على أرقام تعريف التحذيرات التي يجب أن تٌعامل على أنها أخطاء و التي يمكن استخدامها مع خيارات خط الأوامر لتشغيل التحذيرات المحددة أو إيقاف تشغيلها . إذا كانت قائمة التحذير تحتوي على رقم غير صحيح, يتم الإعلام عن خطأ.

أمثلة

يصف هذا جدول أمثلة وسيطات خط الأوامر و ما تفعله كل وسيطة.

الوسيطة	الوصف
vbc /warnaserror	تعيّن أن كل التحذيرات يجب أن تتم معاملتها على أنها أخطاء.
vbc /warnaserror:42024	تعيّن أن تحذير 42024 يجب أن تتم معاملته على أنه خطأ.
vbc /warnaserror:42024,42025	تعيّن أن التحذيرات 42024 و 42025 يجب أن تتم معاملتها على أنها أخطاء.
vbc /nowarn	تعيّن أنه لا يجب أن يُعلن عن أية تحذيرات.
vbc /nowarn:42024	تعيّن أن النحذير 42024 لا يجب أن يُعلن عنه .
vbc /nowarn:42024,42025	تعيّن أنه لا يجب الإعلام عن التحذيرات 42024 و 42025.

أنواع التحذيرات

قائمة التالية للتحذيرات التي قد تحتاج معاملته كأخطاء.

تحذير التحويل الضمني

تم إنشاؤه من أجل مثيلات التحويل الضمني. و هي لا تقم بتضمين التحويلات الضمنية من النوع عددي المضمن إلى السلسلة عند استخدام عامل التشغيل & . الوضع الافتراضي للمشاريع الجديدة هو إيقاف التشغيل .

ID: 42016

استدعاء أسلوب القيد المتأخر و زيادة التحميل تحذير الدقة

تم إنشاؤه من أجل مثيلات الربط. المتأخر الوضع الافتراضي للمشاريع الجديدة هو إيقاف التشغيل .

ID: 42017

المعاملات من نوع تحذيرات الكائن

تم الإنشاء عند وجود المعاملات من النوع Object التي قد تؤدي إلى إنشاء خطأ مع Option Strict On. الوضع الافتراضي للمشاريع الجديدة هو التشغيل .

ID: 42018 و42019

تتطلب التعريفات تحذيرات عبارة 'As'

تم الإنشاء عند تعريف المتغير أو الدالة أو تعريف خاصية ينقصها عبارة As قد ينشئ خطأ مع Option Strict On. المتغيرات التي لم يتم تعيين النوع لها يتم افتراض أنها من النوع Object. الوضع الافتراضي للمشاريع الجديدة هو التشغيل .

ID: (تعريف الخاصية) 42020 ، (تعريف الدالة) 42021 ، (تعريف الخاصية) 42022 .

تحذيرات استثناء المرجع فارغ محتملة

تم الإنشاء عند استخدام المتغير قبل تعيين القيمة. الوضع الافتراضي للمشاريع الجديدة هو التشغيل .

ID: 42104, 42030

تحذير المتغير المحلي غير المستخدم

تم الإنشاء عند تعريف المتغير المحلي ولكن لا يتم الإشارة إليه. الوضع الافتراضي هو التشغيل.

ID: 42024

وصول العضو المشترك من خلال تحذير متغير المثيل

الإنشاء عند الوصول إلى العضو المشترك بواسطة المثيل قد يكون له تأثيرات جانبية أو عند الوصول إلى عضو مشترك بواسطة متغير المثيل لايعتبر الجانب الأيمن من التعبير أو يتم تمريره في المعلمة. الوضع الافتراضي للمشاريع الجديدة هو التشغيل .

ID: 42025

عامل التشغيل المتداخل أو خاصيةوصول التحذيرات

تم الإنشاء عندما يستخدم جسم الروتين نفس عامل التشغيل أو الخاصية التي تم تعريفه فيها . الوضع الافتراضي للمشاريع الجديدة هو التشغيل .

ID: 42004 (عامل) ، 42026 (خاصية)

دالة أو عامل تشغيل بدون تحذير القيمة المرجعة

تم الإنشاء عندما لم يكن لدى الدالة أو عامل التشغيل قيمة مرجعة محددة. ويتضمن ذلك إهمال Set للمتغير المحلي الضمني بنفس اسم دالة. الوضع الافتراضي للمشاريع الجديدة هو التشغيل .

ID: 42105 (دالة) ، 42016 (عامل تشغيل)

تحميل المعدّل المستخدم في تحذير الوحدة النمطية بشكل زائد

تم الإنشاء عند استخدام Overloads في Module. الوضع الافتراضي للمشاريع الجديدة هو التشغيل .

ID: 42028

الالتقاط المكررة أو تراكب كتل التحذيرات

تم الإنشاء عند عدم وصول كتلة Catch بسبب علاقتها بكتل Catch الأخرى التي تم تعريفها. الوضع الافتراضي للمشاريع الجديدة هو التشغيل .

ID: 42029, 42031

راجع أيضًا:

مشاركة عبر