مشاركة عبر

بنية التخصيصات على مستوى المستند

  • مقالة

ينطبق على

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

نوع المشروع

  • مشروعات على مستوى المستند

إصدار Microsoft Office

  • نظام 2007 Microsoft Office

  • Microsoft Office 2010

Visual Studio 2010 يتضمن المشاريع لإنشاء التخصيصات على مستوى المستند لـ Microsoft Office Word و Excel يصف هذا الموضوع الأوجه التالية من التخصيصات على مستوى المستند :

  • فهم التخصيصات

  • مكونات التخصيصات

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

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

فهم التخصيصات

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

عند قيام مستخدم بفتح المستند يتم تحميل التجميع من قبل تطبيق Microsoft Office. بعد تحميل التجميع يمكن أن يستجيب التخصيص للأحداث بينما يكون المستند مفتوحاً. يمكن أيضاً أن تَستدعى التخصيص إلى نموذج الكائن لأتمتة وتوسيع التطبيق و المستند مفتوح ,ويمكن استخدام أي من الفئات في .NET Framework.

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

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

ملاحظة

For غير ذلك applications, the مربع اختيار هو located في the عام مقطع of the تفاصيل جزء. في حالة بدء تشغيل التطبيق بشكل برمجي (على سبيل المثال، باستخدام التنفيذ التلقائى) ، قد لا يعمل التخصيص كما هو متوقع.

خبرات وقت التصميم ووقت التشغيل

لفهم بنية التخصيصات على مستوى المستند ،يساعدنا فى ذلك فهم خبرات تصميم و تشغيل حل

وقت التصميم

خبرات وقت التصميم تتضمن الخطوات التالية:

  1. المطور يقوم بإنشاء مشروع على مستوى المستند في Visual Studio. يتضمن المشروع المستند و التجميع الذى يعمل خلف المستند. المستند قد يكون موجوداً مسبقاً(ربما تم إنشاؤه بواسطة مصمم) أو يمكن إنشاء مستند جديد مع المشروع.

  2. المصمم (إما المطوِّر الذي قام بإنشاء المشروع أو شخص آخر ) يقوم بإنشاء الشكل و الانطباع النهائي للمستند للمستخدم.

وقت التشغيل

خبرات وقت التجربة يتضمن الخطوات التالية:

  1. يقوم المستخدم بفتح المستند أو المصنف الذي يحتوي على ملحقات تعليمات برمجية مدارة.

  2. المستند أو المصنف يقوم بتحميل التجميع المترجم برمجياً.

  3. يستجيب التجميع للأحداث عندما يعمل المستخدم في المستند أو المصنف.

مقارنة منظور المطور والمستخدم

لأن المطور يعمل أساساً في Visual Studio ، و يعمل المستخدم النهائي في Word أو Excel ، توجد طريقتان لفهم التخصيصات على مستوى المستند

منظور المطور

منظور المستخدم

باستخدام Visual Studio ، يكتب المطور التعليمات البرمجية التي يتم الوصول إليها عبر Word و Excel.

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

الأشخاص الذين يستخدمون المستند أو المصنف يقومون ببساطة بفتح الملف (أو يقومون بإنشاء مستند جديد من قالب) فقط كفتح أي ملف Microsoft Office آخر.

يوفر التجميع تخصيصات في المستند أو المصنف مثل ملئه تلقائياً بالبيانات الحالية أو عرض مربع حوار لطلب معلومات.

تنسيقات المستند المعتمدة من أجل التخصيصات على مستوى المستندات

عند قيامك بإنشاء مشروع تخصيص يمكنك اختيار تنسيق المستند الذي تريد استخدامه في المشروع. لمزيد من المعلومات، راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

يسرد الجدول التالي تنسيقات المستند التي يمكنك استخدامها في التخصيصات على مستوى المستند الخاصة بـ Word وExcel.

Excel

Word

مصنف Excel ـ(*.xlsx)

مصنف Excel الممكن بماكرو (*.xlsm)

مصنف Excel الثنائى (*.xlsb)

مصنف Excel 97-2003 ـ(*.xlsx)

قالب Excel ـ(*.xltx)

قالب Excel الممكن بماكرو (*.xltm)

قالب Excel 97-2003ـ (*.xltx)

مستند Wordـ (.docx)

مستند Word الممكن بماكرو (*.docm)

مستند Word 97-2003 ـ(*.docx)

قالب Word ـ(.dotx)

قالب Word الممكن بماكرو (.dotm)

قالب Word 97-2003 ـ(.dotx)

يجب تصميم ملحقات التعليمات البرمجية المُدارة فقط على المستندات بالتنسيقات المدعومة. وإلا، فقد فإن أحداثاً معينة قد لا يتم رفعها عند فتح المستند في التطبيق. على سبيل المثال ,الحدثOpen لا يتم رفعه عند استخدام ملحقات تعليمات برمجية مدارة مع المصنفات المحفوظة بتنسيق جدول بيانات XML Excel أو بتنسيق صفحة ويب (.htm; .html).

الدعم لمستندات Word التي لها امتدادات اسم الملف .xml

لا تسمح لك القوالب على مستوى المشروع بإنشاء مشاريع مستندة إلى تنسيقات الملفات التالية:

  • مستند Word XMLـ(* xml).

  • مستند Word 2003 XMLـ(* xml).

إذا كنت تريد المستخدمين الخاصين بك أن يستخدموا تخصيصات بتنسيقات الملفات هذه ، قم ببناء و نشر تخصيص يستخدم أحد تنسيقات الملفات المدعمة المعينة في الجدول أعلاه. بعد تثبيت "التخصيص" ، يمكن للمستخدمين النهائيين حفظ المستند في تنسيق Word XML ـ(* xml) أو Word 2003 XML ـ (* xml) و التخصيص سيستمر في العمل كما هو متوقع.

مكونات التخصيصات

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

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

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

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

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

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

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

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

بيان النشر يشير إلى بيان التطبيق، و الذى يشير بالتالى إلى أحدث التجميعات حالياً لمزيد من المعلومات، راجع بيانات التطبيق و النشر في حلول Office.

يبين الرسم التوضيحي التالي البنية الأساسية من التخصيص على مستوى المستند.

بنية التخصيص

هندسة تخصيص 2007 Office

ملاحظة

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

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

الخطوات التالية تحدث عندما يقوم مستخدم بفتح مستند هو جزء من حل Microsoft Office :

  1. تطبيق Microsoft Office يقوم بالتحقق من خصائص المستند المخصصة لمعرفة ما إذا كان هناك ملحقات تعليمات برمجية مدارة مقترنة بالمستند. لمزيد من المعلومات، راجع نظرة عامة على خصائص مستند مخصص.

  2. إلى إظهار إضافة-في مستخدم واجهة أخطاء for Outlook 2007 إذا كانت Microsoft المكتب إنهاء تطبيق بشكل غير متوقع أو حدوث خطأ أثناء يتم تهيئة وظيفة إضافية، قد يقوم تطبيق بتعطيل الوظيفة الإضافية.Visual Studio Tools لـ Office Runtime لمزيد من المعلومات، راجع نظرة عامة حول أدوات Visual Studio لوقت تشغيل Office.

  3. يقوم VSTOLoader.dll بتحميل .NET Framework ثم يبدأ الجزء المدار من Visual Studio Tools لوقت تشغيل Office.

  4. إذا فتح المستند من موقع آخر غير الكمبيوتر المحلي، يتحقق Visual Studio Tools لوقت تشغيل Office من أن موقع المستند في القائمة المواقع الموثوقة في إعدادات مركز التوثيق لذلك التطبيق المعين من تطبيقات Office. إذا لم يكن موقع المستند في موقع موثوق به, التخصيص يكون غير موثوق به، و تتوقف عملية التحميل هنا.

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

  6. إذا كانت التخصيص موثوق للتشغيل، تستخدم Visual Studio Tools لوقت تشغيل Office بيان التوزيع و بيان التطبيق لاختبار تحديثات التجميع. في حالة توفر إصدار جديد من التجميع, يقوم وقت التشغيل بتحميل إصدار جديد من التجميع إلى ذاكرة التخزين المؤقت الخاصة بـ ClickOnce على كمبيوتر العميل. لمزيد من المعلومات، راجع توزيع حلول Office.

  7. Visual Studio Tools لوقت تشغيل Office يقوم بإنشاء مجال تطبيق جديد حيث سيتم تحميل تجميع التخصيص.

  8. يقوم Visual Studio Tools لوقت تشغيل Office بتحميل تجميع التخصيص في مجال التطبيق.

  9. Visual Studio Tools لوقت تشغيل Office يستدعى معالج الحدث Startup في تجميع التخصيص الخاص بك. لمزيد من المعلومات، راجع الأحداث في مشاريع Office.

راجع أيضًا:

المبادئ

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

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

نظرة عامة على خصائص مستند مخصص

البيانات المخزنة مؤقتًا في تخصيصات على مستوى المستند

موارد أخرى

بنية حلول Office في Visual Studio

تأمين حلول Office

تصميم و إنشاء حلول Office