/debug (خيارات المحول البرمجي C#)
الخيار /debug يجعل المحول البرمجي ينشئ معلومات تصحيح الأخطاء ويضعها في ملف أو ملفات الإخراج.
/debug[+ | <U>-</U>]
/debug:{<U>full</U> | pdbonly}
الوسيطات
+ | -
تحديد +, أو فقط /debug ، يجعل المحول البرمجي ينشئ معلومات تصحيح الأخطاء ويضعها في قاعدة بيانات البرنامج (ملف .pdb). تحديد - ، و الذي يكون ساري المفعول إذا لم تقم بتعيين /debug, لا يسبب إنشاء أي بيانات تصحيح الأخطاء.full | pdbonly
يحدد نوع معلومات التصحيح التي تم إنشاؤها بواسطة المحول البرمجي. الوسيطة الكاملة ,و التي تكون نافذة المفعول في حالة عدم تحديد /debug:pdbonly ، تقوم بتمكين إرفاق مصحح أخطاء للبرنامج قيد التشغيل. تحديد pdbonly يسمح بتصحيح أخطاء التعليمات البرمجية للمصدر عند بدء البرنامج في مصحح الأخطاء ولكن سيتم عرض المجمّع فقط عند إرفاق البرنامج قيد التشغيل بمصحح الأخطاء.
ملاحظات
استخدم هذا الخيار لإنشاء بنيات تصحيح الأخطاء. إذا كان /debug ، /debug+, أو /debug:full لم يتم تحديده , لن تكون قادراً على تصحيح أخطاء ملف إخراج برنامجك.
إذا كنت تستخدم /debug:full ، يجب أن تدرك أن هناك بعض التأثير على سرعة وحجم التعليمات البرمجية المحسّنة JIT و تأثير صغير على جودة التعليمات البرمجية مع /debug:full. نوصي بـ /debug:pdbonly أو عدم استخدام PDB لإنشاء التعليمات البرمجية للإصدار.
ملاحظة
أحد الفروق بين /debug:pdbonly و /debug:full أنه مع /debug:full يخرج المحول البرمجي DebuggableAttribute ، الذي يُستخدم لإخبار مترجم JIT معلومات تصحيح الأخطاء متوافرة. لذلك، سوف تحصل على خطأ إذا كانت التعليمة البرمجية الخاصة بك تحتوي على DebuggableAttribute معيّنة false إذا كنت تستخدم /debug:full.
للحصول على مزيد من المعلومات حول كيفية تكوين أداء تصحيح الأخطاء لتطبيق, راجع جعل الصورة أسهل لتصحيح الأخطاء.
لتغيير موقع ملف .pdb, راجع /pdb (خيارات المحول البرمجي C#).
لتعيين خيار المحول البرمجي هذا في بيئة تطوير Visual Studio
افتح صفحة خصائص للمشروع.
انقر فوق صفحة خاصية إنشاء .
انقر فوق الزر Advanced (خيارات متقدمة).
عدّل الخاصية معلومات تصحيح الأخطاء.
للحصول على معلومات حول تعيين خيار المحول البرمجي هذا بشكل برمجي, راجع DebugSymbols.
مثال
ضع معلومات التصحيح في ملف الإخراج app.pdb:
csc /debug /out:app.pdb test.cs