بنية الوظائف الإضافية على مستوى التطبيق

مقالة
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 Office.

للحصول على معلومات عامة حول إنشاء وظائف إضافية، راجع نظرة عامة حول تطوير حلول Office و البدء في برمجة وظائف إضافية على مستوى التطبيق.

فهم الوظائف الإضافية.

انقر في خلية إلى يمين خلية "تصنيف مستوى رضا" وحدد واحد من الخيارات متوفر. بعد تحميل التجميع ، يمكن للوظائف الإضافية في التجميع الاستجابة للأحداث التي يتم رفعها في التطبيق (على سبيل المثال، عند قيام مستخدم بالنقر فوق عنصر قائمة). يمكن أيضاً أن تَستدعى الوظيفة الإضافية إلى نموذج الكائن لأتمتة وتوسيع التطبيق ,ويمكن استخدام أي من الفئات في .NET Framework.

يتصل التجميع بمكونات COM الخاصة بالتطبيق من خلال تجميع التوافق الأساسي للتطبيق. للمزيد من المعلومات، راجع مكتب التجميعات إمكانية التشغيل المتداخل الأساسية ونظرة عامة حول تطوير حلول Office.

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

ملاحظة

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

مكوّنات الوظائف الإضافية

على الرغم من أن تجميع الوظيفة الإضافية هو المكوّن الأساسي, هناك العديد من المكونات الأخرى التي تلعب دوراً هاماً في كيفية اكتشاف تطبيقات Microsoft Office و تحميل الوظائف الإضافية.

إدخالات السجل

تكتشف تطبيقات Microsoft Office الوظائف الإضافية من خلال البحث عن مجموعة من إدخالات التسجيل. للحصول على قائمة كاملة لإدخالات السجل المستخدمة من قبل الوظائف الإضافية راجع إدخالات السجل للوظائف الإضافية على مستوى التطبيق.

حالة تجميع هو متوفرة، الاختيار ما إذا كان الكلمة أو Excel هو تشغيل تخصيص، مثل الوظيفة الإضافية أو علامة ذكى أو مستند الذكي، الذي وضوح تحميل نسخة من وقت إطار عمل.NET تشغيل اللغة العامة (CLR) التي هو غير متوافق مع. لمزيد من المعلومات، راجع نظرة عامة حول عملية بناء حل Office.

إذا كنت تستخدم ClickOnce لنشر الحل الخاص بك ، يقوم برنامج "الإعداد" التي تم إنشاؤه بواسطة عملية النشر تلقائياً بإنشاء مفاتيح التسجيل على كمبيوتر المستخدم النهائي. لمزيد من المعلومات، راجع نشر حلول Office.

بيان التوزيع وبيان التطبيق

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

أدوات Visual Studio لـوقت تشغيل Office

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

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

كيفية عمل الوظائف الإضافية مع تطبيقات Microsoft Office.

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

بنية الوظيفة الإضافية

هندسة الوظائف الإضافية لـ 2007 Office

ملاحظة

في حلول Office التى تهدف إلى.NET Framework 4 ، الحلول تَستدعى إلي نموذج الكائن من تطبيق المضيف باستخدام المعلومات من نوع PIA المضمنة في تجميع الحل، بدلاً من الاستدعاء مباشرة إلى PIA . لمزيد من المعلومات، راجع تصميم و إنشاء حلول Office.

عملية التحميل

الخطوات التالية تحدث عندما يقوم مستخدم ببدء تشغيل التطبيق:

أداة إضافة في عدم تحميل أو هو Dهوabled
هناك عدة إمكانيات للتحقق إذا كان المستوى تطبيقات من إضافة-في لا يحمل بشكل صحيح: إذا كانت Microsoft المكتب إنهاء تطبيق بشكل غير متوقع أو حدوث خطأ أثناء يتم تهيئة وظيفة إضافية، قد يقوم تطبيق بتعطيل الوظيفة الإضافية.Visual Studio Tools لـ Office Runtime لمزيد من المعلومات، راجع نظرة عامة حول أدوات Visual Studio لوقت تشغيل Office.
يقوم VSTOLoader.dll بتحميل .NET Framework ثم يبدأ الجزء المدار من Visual Studio Tools لوقت تشغيل Office.
يقوم Visual Studio Tools لوقت تشغيل Office بالتحقق من تحديثات البيان، و يقوم بتنزيل بيانات التطبيق و التوزيع الأحدث.
يقوم Visual Studio Tools لوقت تشغيل Office بتنفيذ سلسلة من اختبارات الأمان. لمزيد من المعلومات، راجع تأمين حلول Office.
إذا كانت الوظيفة الإضافية موثوقة للتشغيل، تستخدم Visual Studio Tools لوقت تشغيل Office بيان التوزيع و بيان التطبيق لاختبار تحديثات التجميع. في حالة توفر إصدار جديد من التجميع, يقوم وقت التشغيل بتحميل إصدار جديد من التجميع إلى ذاكرة التخزين المؤقت الخاصة بـ ClickOnce على كمبيوتر العميل. لمزيد من المعلومات، راجع توزيع حلول Office.
يقوم Visual Studio Tools لوقت تشغيل Office بإنشاء مجال تطبيق جديد حيث يتم تحميل وظيفة إضافية في التجميع.
يقوم Visual Studio Tools لوقت تشغيل Office بتحميل تجميع الوظيفة الإضافية في مجال التطبيق.
يقوم Visual Studio Tools لوقت تشغيل Office باستدعاء أسلوب RequestComAddInAutomationService في الوظيفة الإضافية الخاصة بك ،إذا قمت بتجاوزها.

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

يمكنك اختياريا تجاوز هذا الأسلوب لتوسيع ميزة Microsoft Office بإرجاع الكائن الذي يقوم بتنفيذ واجهة القابلية للتوسعة. لمزيد من المعلومات، راجع تخصيص ميزات UI باستخدام الواجهات القابلة للتوسعة.
The Visual Studio Tools لوقت تشغيل Office calls the ThisAddIn_Startup method in your add-in. Microsoft المكتب قد يتم تشغيل تطبيق إحدى الوظائف الإضافية التي تقوم بوضوح تحميل نسخة من وقت إطار عمل.NET تشغيل اللغة العامة (CLR) غير متوافق مع Startup. لمزيد من المعلومات، راجع الأحداث في مشاريع Office.

ملاحظة

يقوم Visual Studio Tools لوقت تشغيل Office باستدعاءات منفصلة للأسلوب RequestService لكل واجهة توسعة يتم دعمها عن طريق التطبيق المضيف. على الرغم من أن الاستدعاء الأول لأسلوب RequestService يحدث عادة قبل استدعاء أسلوب ThisAddIn_Startup, إلا أن الوظيفة الإضافية الخاصة بك لا يمكنها عمل افتراض متى سيتم استدعاء أسلوب RequestService أو عدد مرات استدعاؤه.