نظرة عامة حول أدوات Visual Studio لوقت تشغيل Office

مقالة
11/01/2010

To run solutions that are created by using the Microsoft Office developer tools in Visual Studio 2010, the Visual Studio Tools لـ Office Runtime must be installed on end user computers. Visual Studio Tools لـ Office Runtime يتكون من مكونين الرئيسي:

ملحقات Office لـ .NET Framewoork. هذه المكونات هي تجميعات مدارة توفر طبقة الاتصال بين الحل الخاص بك و تطبيق Microsoft Office. لمزيد من المعلومات، راجع فهم ملحقات Office لـ .NET Framework .
محمل حل Office. هذا المكون هو مجموعة من DLLs غير مدارة تستخدمها تطبيقات Office لتحميل وقت التشغيل والحلول. لمزيد من المعلومات، راجع فهم محمل حلول Office.

يمكن أن يتم تثبيت وقت التشغيل بعدة طرق مختلفة. اعتمادًا على تكوين الكمبيوتر، يتم تثبيت مكونات وقت تشغيل مختلفة عند تثبيت وقت التشغيل. لمزيد من المعلومات، راجع أدوات Visual Studio لسيناريوهات التثبيت وقت التشغيل.

فهم ملحقات Office لـ .NET Framework.

يتضمن Visual Studio Tools لـ Office Runtime اثنين من ملحقات Office لـ .NET Framework:

ملحقات Office لـ .NET Framework مستخدمة من قبل الحلول التي تستهدف .NET Framework 3.5.
ملحقات Office لـ.NET Framework 4 مستخدمة من قبل الحلول التي تستهدف .NET Framework 4.

تتكون هذه الملحقات من تجميعات تستخدم حلولك للتنفيذ التلقائي وتوسيع تطبيقات Office. عند إنشائك لمشروع Office، يقوم Visual Studio تلقائياً بإضافة مراجع إلى التجميعات‬ التي تُستخدم لنوع المشروع و .NET Framework المستهدف من قبل المشروع. للحصول على معلومات حول التجميعات في ملحقات Office ، راجع التجميعات في أدوات Visual Studio الخاصة بوقت تشغيل Office.

اختلافات التصميم في ملحقات Office

معظم الأنواع التي تستخدمها في ملحقات Office لـ .NET Framework 3.5 تكون عبارة عن فئات. هذه هى نفس الفئات التى كانت مضمنة فى الإصدارات السابقة من Visual Studio Tools لوقت تشغيل Office. على الوجه الآخر، أكثر الأنواع التى تستخدمها فى ملحقات Office لـ .NET Framework 4 هى واجهات. على سبيل المثال، عند استهدافك .NET Framework 4 ، تكون الأنواع Microsoft.Office.Tools.Excel.Worksheet و Microsoft.Office.Tools.Word.Document واجهات بدلاً من فئات.

في معظم الحالات، التعليمات البرمجية التي تكتبها في حلول Office هي نفسها سواء كان حلك يستهدف .NET Framework 3.5 أو .NET Framework 4. ومع ذلك، تتطلب بعض الميزات تعليمات برمجية مختلفة عند استهداف إصدارات مختلفة من .NET Framework. لمزيد من المعلومات، راجع ترحيل حلول Office إلى .NET Framework 4.

الواجهات في ملحقات Office لـ .NET Framework 4

معظم الواجهات في ملحقات Office لـ .NET Framework 4 غير معدة لتطبيقها من قبل التعليمات البرمجية للمستخدم. الواجهات الوحيدة التي يمكنك تنفيذها مباشرة هى فقط التى لها أسماء تبدأ بالحرف I ، مثل ISmartTagExtension.

كافة الواجهات التي لا تبدأ بالحرف I يتم تطبيقها داخليًا بواسطة Visual Studio Tools لـ Office Runtime ، و قد تتغير هذه الواجهات في الإصدارات المستقبلية. لإنشاء الكائنات التي تقوم بتطبيق هذه الواجهات، استخدم الأساليب التي يوفرها الكائن Globals.Factory في المشروع الخاص بك. على سبيل المثال، للحصول على كائن يطبق الواجهة SmartTag، استخدم الأسلوب Globals.Factory.CreateSmartTag . لمزيد من المعلومات حول Globals.Factory، راجع الوصول العمومي إلى الكائنات في مشاريع Office.

تمكين مساواة الأنواع والأنواع المضمّنة في مشاريع تستهدف .NET Framework 4

نموذج الكائنات المستند إلي الواجهات لملحقات Office لـ .NET Framework 4 يمكّنك من استخدام ميزة مساواة الأنواع في Visual C# 2010 و Visual Basic 2010 لتضمين معلومات النوع من Visual Studio Tools لوقت تشغيل Office إلى الحل الخاص بك . تمكّن هذه الميزة حلول Office و Visual Studio Tools لوقت تشغيل Office من الإصدار بشكل مستقل عن بعضها البعض. على سبيل المثال، إذا كان الحل الخاص بك يستخدم الواجهة Microsoft.Office.Tools.Word.Document كنوع مضمن، و قام إصدار وقت التشغيل التالي بإضافة أعضاء للواجهة Microsoft.Office.Tools.Word.Document ، فسيظل الحل الخاص بك يعمل بالإصدار التالي من وقت التشغيل. إذا كان الحل الخاص بك لا يستخدم واجهات Microsoft.Office.Tools.Word.Document كنوع مضمن ، لن يعمل الحل الخاص بك بالإصدار التالي من وقت التشغيل.

بشكل افتراضي، ميزة مساواة الأنواع لا يتم تمكينها عندما تقوم بإنشاء مشروع Office يستهدف .NET Framework 4. إذا أردت تمكين هذه الميزة ، قم بتعيين الخاصية أنواع توافقية مضمنة لأي من مراجع التجميع التالية في المشروع إلي True:

Microsoft.Office.Tools.dll
Microsoft.Office.Tools.Common.dll
Microsoft.Office.Tools.Excel.dll
Microsoft.Office.Tools.Outlook.dll
Microsoft.Office.Tools.Word.dll

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

فهم أداة تحميل حلول Office

وقت التشغيل Visual Studio Tools لـ Office يتضمن عدة DLLs غير مدارة تستخدمها تطبيقات Office لتحميل حلول وقت التشغيل و حلول Office. على الرغم من أنه لا يجب أن تعمل مع هذه الـ DLLs مباشرةً ، معرفة أغراض هذه الـ DLLs تساعد في فهم أفضل لبنية حلول Office.

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

VSTOEE.dll

عند قيام مستخدم بفتح تخصيص علي مستوى المستند أو بدء تشغيل وظيفة إضافية ، يستدعي تطبيق Office إلى VSTOEE.dll لتنفيذ المهام المطلوبة لتحميل Visual Studio Tools لوقت تشغيل Office.

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

VSTOLoader.dll

بعد تحميل VSTOEE.dll للإصدار المناسب من Visual Studio Tools لوقت تشغيل Office ، يقوم VSTOLoader.dll بأداء معظم العمل المطلوب لتحميل تجميع الحل. يؤدي VSTOLoader.dll عدة أشياء:

إنشاء مجال تطبيق لكل تجميع حل.
تنفيذ مجموعة من عمليات تدقيق الأمان للتحقق من أن تجميع الحل لديه الإذن للتشغيل.
تحميل إصدار ملحقات Office لـ .NET Framework المطلوب من قبل الحل.

يؤدي VSTOLoader.dll أيضاً العديد من الأشياء الخاصة بالوظائف الإضافية:

يطبق الواجهة IDTExtensibility2 بعض التطبيقات في الإصدار 2007 Microsoft المكتب الالنظام باستخدام قوائم وأشرطة الأدوات لتطبيق واجهة المستخدم الرئيسي.IDTExtensibility2 تعرّف هذه الواجهة أساليب يستدعيها التطبيق للاتصال بالوظيفة الإضافية.
يطبق الواجهة IManagedAddin يتم استخدام هذه الواجهة بواسطة تطبيقات Office للمساعدة في تحميل الوظائف الإضافية علي مستوي التطبيق. لمزيد من المعلومات، راجع واجهة IManagedAddin.

فهم إصدارات 32-bit و 64-bit لوقت التشفيل

هناك إصدارات منفصلة 64-bit و 32-bit لـ Visual Studio Tools لـ Office Runtime. يتم استخدام هذه الإصدارات من وقت التشغيل لتشغيل حلول في إصدارات 64-bit و 32-bit لـ Microsoft Office 2010. يعرض الجدول التالي أي إصدارات من وقت التشغيل مطلوبة من أجل كل تركيبة من Microsoft Windows و Microsoft Office 2010.

إصدار Microsoft Windows	إصدار Microsoft Office	الإصدار المطلوب من أدوات Visual Studio الخاصة بوقت تشغيل Office
32 بت	32 بت	32 بت
64‏-بت	32 بت	64‏-بت
64‏-بت	64‏-بت	64‏-بت

عند تثبيت Microsoft Office 2010 ، الإصدار المطلوب من Visual Studio Tools لوقت تشغيل Office يتم تثبيته مع Office. على سبيل المثال ، عند تثبيت إصدار 64-bit من Microsoft Office 2010 على إصدار 64-bit من Microsoft Windows ، الإصدار 64-bit من Visual Studio Tools لوقت تشغيل Office يتم تثبيته أيضاً. للحصول على مزيد من المعلومات حول تثبيت Visual Studio Tools لوقت تشغيل Office مع Microsoft Office 2010، راجع أدوات Visual Studio لسيناريوهات التثبيت وقت التشغيل.

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

راجع أيضًا:

مشاركة عبر