تصحيح الأخطاء في مشاريع علي مستوي التطبيق

مقالة
11/01/2010

ينطبق على
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع مشروعات على مستوى التطبيق إصدار Microsoft Office نظام 2007 Microsoft Office Microsoft Office 2010

تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع.

نوع المشروع

مشروعات على مستوى التطبيق

إصدار Microsoft Office

نظام 2007 Microsoft Office
Microsoft Office 2010

يمكنك استخدام Microsoft المكتب أدوات المطورين لتطوير حلول المكتب ل Visual Studioوفي 2007 Microsoft المكتب النظام.Visual Studio Visual Studioيتضمن قوالب مشروع جديد لإنشاء حلول لهذا الهدف**.** لمزيد من المعلومات حول أدوات التصحيح Visual Studio، راجع تصحيح الأخطاء في ‏‫Visual Studio. لمزيد من المعلومات حول المشاريع على مستوى التطبيق ، راجع بنية الوظائف الإضافية على مستوى التطبيق .

ارتباط إلى فيديو للحصول على عرض فيديو توضيحي ذي صلة، راجع كيف يمكنني القيام بما يلي: تصحيح تطبيق VSTO؟.

بدء تشغيل و إيقاف المصحح

يمكنك بدء تصحيح مشروع على مستوي التطبيق تماماً مثل بدء تصحيح مشاريع Visual Studio الأخري; على سبيل المثال، يمكنك ضغط مفتاح F5. عند بدء تشغيل تصحيح المشروع الخاص بك، تبدأ عملية جديدة لتطبيق Office المستهدف و يتم تحميل الوظيفة الإضافية. عندما تقوم بإغلاق مصحح الأخطاء، يقوم المصحح بإنهاء عملية التطبيق فجأة أو يفصل إذا كان المصحح معيّناً للفصل. لمزيد من المعلومات، راجع Debugging Shortcut Keys, Brief Scheme.

عرض الاستثناءات

إذا قامت وظيفة إضافية منشأة باستخدام أدوات تطوير Office في Visual Studio برفع استثناء، يستمر تطبيق Microsoft Office بدون عرض الاستثناء. قم بتعيين مصحح الأخطاء للفصل عند كافة الاستثناءات إذا كنت ترغب في مشاهدة متى تقوم الوظائف الإضافية برفع الاستثناءات. لمزيد من المعلومات، راجع كيفية القيام بما يلي: معالجة أخطاء في مشاريع Office.

يمكنك أيضاً إدراج بيانات Try...Catch حول التعليمة البرمجية التي قد تقوم بإلقاء استثناء. للحصول على مزيد من المعلومات حول كيفية استخدام البيانات Try...Catch، راجع كيفية: اختبار التعليمات البرمجية مع كتلة Try…Catch في Visual Basic و كيفية: معالجة "الاستثناءات استخدام" حاول/catch (C# برمجة الدليل).

تصحيح الوظائف الإضافية المعطّلة

يمكن لتطبيقات Microsoft Office أن تقوم بتعطيل الوظائف الإضافية التي تسلك سلوكًا غير متوقع أثناء تحميلها. تقوم أحد تطبيقات Microsoft Office بتعطيل الوظائف الإضافية لمنع التعليمات البرمجية المشكوك فيها من التحميل كل مرة يتم فيها بدء تشغيل التطبيق. ومع ذلك، من السهل أيضاً التسبب في حدوث سلوك غير متوقع أثناء عملية تصحيح نموذجية. للحصول على معلومات حول كيفية إعادة تمكين الوظائف الإضافية، راجع كيفية القيام بما يلي: إعادة تمكين وظيفة إضافية تم تعطيلها.

هناك نوعان من التعطيل تقوم تطبيقات Microsoft Office باستخدامهم للوظائف الإضافية: التعطيل القوي و التعطيل الضعيف.

التعطيل القوي

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

إذا كان تطبيق Office يقوم بالتعطيل القوي للوظيفة الإضافية التي تم إنشاؤها بواسطة أدوات تطوير Office في Visual Studio، يقوم التطبيق بتعطيل فقط الوظيفة الإضافية التي تسبب الفشل. نتيجة لذلك، الوظائف الإضافية الأخرى التي تم إنشاؤها بواسطة أدوات تطوير Office في Visual Studio لتطبيق Office هذا، ستستمر في التحميل.

التعطيل الضعيف

التعطيل الضعيف يحدث عندما تطرح وظيفة إضافية ما استثناء غير معالج في المنشئ أو في معالج الحدث Startup و لا يغلق تطبيق Microsoft Office بشكل غير متوقع. قد يقوم التطبيق بتعطيل الوظائف الإضافية الحالية فقط عن التحميل للمستخدم الحالي. طريقة الوصول إلى LoadBehaviorأسلوب يعتمد تشغيل أي الإصدار من برنامج.NET Framework أهداف مشروع: في مشاريع التي تستهدف 3.5 إطار عمل.NET، استخدم LoadBehaviorأسلوب مثيل من واحد الأنواع التالية في Excel و الكلمة الأساسي إمكانية التشغيل المتداخل تجميعات: HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\< اسم التطبيق >\Addins\< معرّف الوظيفة الإضافية>. لمزيد من المعلومات حول مفتاح التسجيل هذا، راجع إدخالات السجل للوظائف الإضافية على مستوى التطبيق.

استكشاف أخطاء الوظائف الإضافية باستخدام ملف سجل و رسائل خطأ

تستطيع Visual Studio Tools لوقت تشغيل Office كتابة كافة الأخطاء التي تحدث أثناء بدء التشغيل لملف السجل أو عرض كل خطأ في مربع رسالة. بشكل افتراضي، هذه الخيارات غير فعّالة. يمكنك تشغيل الخيارات عن طريق إنشاء متغيرات البيئة.

لعرض كل خطأ في مربع رسالة، قم بإنشاء متغير بيئة يسمى VSTO_SUPPRESSDISPLAYALERTS و قم بتعيينه إلي 0 (صفر). يمكنك منع الرسائل عن طريق حذف متغير البيئة أو تعيينه إلي 1 (واحد).

لكتابة الأخطاء إلى ملف السجل، قم بإنشاء متغير بيئة يسمى VSTO_LOGALERTS و قم بتعيينه إلى 1 (واحد). يقوم Visual Studio Tools لوقت تشغيل Office بإنشاء ملف سجل في المجلد الذي يحتوي على ملف بيان التطبيق. في مشاريع التي تستهدف ، تستخدم الأسلوب، وتمرير في كائن الكلمة أو Excel الأصلي (مثل أو ) الذي تريده إلى توسيع. لا يمكنك إضافة عنصر تحكم في ورقة عمل، أو أو عنصر تحكم إلى مستند، وذلك باستخدام الوظائف-بوصة