ترقية و ترحيل حلول Office

إذا كان لديك مشروع Microsoft Office تم إنشاؤه في إصدار سابق من برنامج Visual Studio، فعليك ترقية المشروع لاستخدامه في Visual Studio 2010. قم بإنشاء الكلمة إضافة-في المشروع باستخدام "مستندات ملء" اسم من قاعدة بيانات، باستخدام Visual أساسى أو C#.Visual Studio 2010 للحصول على مزيد من المعلومات حول عملية الترقية, راجع كيفية القيام بما يلي: تحديث حلول Office. ‏‫Visual Studio بفتح الملف ThisAddIn.vb أو ThisAddIn.cs و إضافة "مستندات ملء" من مشروع قاعدة بيانات إلى من Visual Studio 2010مستكشف الحل.تكوين كمبيوتر لتطوير حلول Office

عندما تقوم بترقية مشروع Microsoft Office، يقوم برنامج Visual Studio بإجراء العديد من التغييرات على المشروع. بعض التغييرات يعتمد على نوع إصدار .NET Framework و Microsoft Office اللذين قمت بتثبيتهما على كمبيوتر المطور، و ما إذا كان المشروع هو مشروع على مستوى المستند أو مشروع على مستوى التطبيق.

يمكنك أيضاً تغيير إطار العمل المستهدف الخاص بمشاريع Office في أي وقت من 3.5 .NET Framework إلى .NET Framework 4, أو العكس. لمزيد من المعلومات، راجع كيفية القيام بما يلي: استهداف محدد لـ NET Framework من إصدار أو ملف تعريف. إذا قمت بتغيير إطار العمل المستهدف قد تكون هناك بعض الخطوات الإضافية المطلوبة لتشغيل الحل المستهدف على أجهزة كمبيوتر التطوير وأجهزة كمبيوتر المستخدم، ولن يتم بعد ذلك التحويل البرمجي للمشروع إذا كان يستخدم ميزات معينة. لمزيد من المعلومات، راجع ترحيل حلول Office إلى .NET Framework 4.

ملاحظة

Visual Studio 2010 لا يمكنه ترقية مشاريع قالب نموذج InfoPath الذي تم إنشاؤه باستخدام إصدارات سابقة من برنامج Visual Studio. هذه الأنواع من المشاريع غير مدعمة في Visual Studio 2010.

إصدارات تمت ترقيتها للمشاريع المدعمة

يمكن ترقية مشاريع Microsoft Office التي تم إنشاؤها باستخدام أي من الإصدارات التالية من Visual Studio Tools لـ Office:

  • Microsoft Visual Studio 2005 Tools لـ Microsoft Office System.

  • Microsoft Visual Studio 2005 Tools لـ 2007 Microsoft Office System (VSTO 2005 SE).

  • Microsoft Visual Studio Tools لنظام Microsoft Office (الإصدار 3.0). إنشاء مشروع المستوى المستندات أو المستوى تطبيق لبرنامج Excel 2007.Visual Studio Tools لـ Office

ملاحظة

Visual Studio 2010 does not support upgrading Microsoft Office projects created by using Visual Studio Tools لـ Office، الإصدار 2003.

ملاحظة

Microsoft.VisualStudio.أدوات.Applications.ServerDocument.dll و Microsoft.VisualStudio.أدوات.Applications.وقت التشغيل.dll (إذا كان مشروع تستهدف ).

تغييرات خاصة بالمشاريع التي تم ترقيتها

عندما تقوم بترقية مشروع Microsoft Office، يقوم برنامج Visual Studio بإجراء التغييرات التالية على المشروع.

  • تحديث إصدار وقت التشغيل Visual Studio Tools لـ Office الذي يستهدفه المشروع إلى Visual Studio Tools لـ Office Runtime.

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

  • قم بتحديث إصدار .NET Framework الذي يستهدفه المشروع إذا لزم الأمر.

  • قم بتحديث مراجع التجميع في المشروع.

  • قم بتعديل المشروع لكي يستهدف إصدار Microsoft Office الذي قمت بتثبيته على كمبيوتر التطوير ( Microsoft Office 2010 أو نظام 2007 Microsoft Office) إذا كان المشروع الأصلي يستهدف إصدارا سابقا من Microsoft Office. إذا لم يتم تثبيت أي إصدار من إصدارات Microsoft Office ، فإن المشروع الذي تم ترقيته سيستهدف نظام 2007 Microsoft Office.

.NET Framework المستهدف

عندما تقوم بترقية مشروع Visual Studio Tools لـ Office في Visual Studio 2010،فإن Visual Studio يقوم بتعديل .NET Framework المستهدف وذلك في الحالات التالية:

  • Microsoft.VisualStudio.أدوات.Applications.ServerDocument.v10.0.dll و Microsoft.VisualStudio.أدوات.Applications.وقت التشغيل.v9.0.dll (إذا كان مشروع 3.5 إطار عمل.NET). في هذه الحالة، يقوم Visual Studio بتعديل المشروع لاستهداف 3.5 .NET Framework إذا كان كلاً من 3.5 .NET Framework و .NET Framework 4 مثبتين على الكمبيوتر الخاص بالتطوير. إذا كان .NET Framework 4 هو فقط المثبت، فإن Visual Studio يقوم بتعديل المشروع لكي يستهدف .NET Framework 4.

  • يستهدف المشروع .NET Framework 3.5، ولكن إذا كان .NET Framework 4 هو فقط المثبت على الكمبيوتر الخاص بالتطوير. في هذه الحالة، فإن Visual Studio يقوم بتعديل المشروع لاستهداف .NET Framework 4.

إذا كان المشروع يستهدف بالفعل .NET Framework 3.5، فإن Visual Studio لن يقوم بتحديث إطار العمل المستهدف في المشروع الذي تمت ترقيته وذلك إذا كان 3.5 .NET Framework أيضًا مثبتًا على كمبيوتر التطوير.

ملاحظة

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

يلخص الجدول التالي التغييرات في إطار العمل المستهدف للمشاريع التي تمت ترقيتها.

إطار العمل المستهدف الخاص بالمشروع الأصلي

إصدارات إطار العمل على الكمبيوتر الخاص بالتطوير

إطار العمل المستهدف الخاص بالمشروع الذي تمت ترقيته

NET Framework 2.0.

NET Framework 3.5.

NET Framework 3.5.

و

.NET Framework 4

NET Framework 3.5.

ملاحظةملاحظة
إذا كان المشروع الأصلي يستهدف ملف تعريف العميل الخاص بـ .NET Framework 3.، فإن المشروع الذي تمت ترقيته سيستهدف 3.5 .NET Framework.

NET Framework 2.0.

NET Framework 3.5.

.NET Framework 4

.NET Framework 4

ملاحظةملاحظة
إذا كان المشروع الأصلي يستهدف ملف تعريف العميل الخاص بـ .NET Framework 3.، فإن المشروع الذي تمت ترقيته سيستهدف .NET Framework 4 Client Profile.

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

مراجع التجميع

يقوم Visual Studio بترقية مراجع التجميع التالية في المشروع:

  • تجميعات التوافق الأساسية في برنامج Microsoft Office.

  • التجميعات في Visual Studio Tools لوقت تشغيل Office. للحصول على مزيد من المعلومات حول هذه التجميعات، راجع نظرة عامة حول أدوات Visual Studio لوقت تشغيل Office.

  • إصدارات جديدة أو محدثة من التجميعات التابعة.

لا يضيف Visual Studio مراجع إلى الإصدارات الجديدة أو المحدثة من التجميعات التي قمت بإضافتها إلى المشروع الأصلي بعد إنشائها. على سبيل المثال، إذا قمت بترقية مشروع وظيفة إضافية في Word 2003 والذي أيضاً يشير إلى تجميع التوافق الأساسي الخاص بـ PowerPoint 2003، فإن Visual Studio يقوم بتعديل المشروع الذي تم ترقيته لكي يشير إلى Word 2007 أو تجميع التوافق الأساسي الخاص بـ Word 2010. ومع ذلك، يجب عليك تحديث المرجع يدوياً لجعله يشير إلى تجميع التوافق الأساسي الخاص بـ PowerPoint.

ترقية مشاريع Microsoft Office 2003

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

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

لكي يتم ترقية مشروع على مستوى المستند في Microsoft Office 2003 يجب أن يكون لديك تطبيق نظام Microsoft Office 2010 أو Microsoft Office 2007 المناسب مثبتاً على كمبيوتر التطوير. على سبيل المثال، يجب تثبيت Word 2007 أو Word 2010 على الكمبيوتر قبل ترقية أحد مشاريع Word 2003.

عندما تقوم بترقية مشروع على مستوى المستند بمستند تم حفظه في تنسيق ثنائي، يجب أن تقرر ما إذا كنت تريد تحويل المستند إلى "تنسيق Open XML" أو إبقاء المستند في تنسيق ثنائي. يجب عليك تحديد تنسيق Open XML ما لم يكن لديك سبب محدد لاستخدام التنسيق القديم. لمزيد من المعلومات حول تنسيق Open XML راجع مقدمة عن الامتدادات الجديدة لأسماء الملفات وتنسيقات Open XML .

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

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

إذا كان ملف الحل الخاص بمشروعك الأصلي يتضمن مشروع إعداد تم تكوينه لتثبيت وظيفة إضافية على مستوى التطبيق ، فإن Visual Studio سيقوم بترقية المشروع إلى مشروع Visual Studio 2010، ولكنه لن يقوم بإجراء أي تغييرات إضافية إلى المشروع. If you want to keep using a Windows Installer file to deploy your add-in, you must modify the Setup project to install new pre-requisites such as the .NET Framework 4 or .NET Framework 3.5, the Visual Studio Tools لـ Office Runtime, and optionally the primary interop assemblies referenced by your add-in. لمزيد من المعلومات، راجع نشر حل Office باستخدام Windows Installer.

إذا كنت تريد استخدام ClickOnce لنشر الوظيفة الإضافية الخاصة بك، يمكنك حذف مشروع الإعداد بالكامل. للحصول على مزيد من المعلومات حول نشر الوظائف الإضافية باستخدام ClickOnce، راجع توزيع حلول Office.

راجع أيضًا:

المهام

كيفية القيام بما يلي: تحديث حلول Office

المرجع

ترقية مربع حوار خيارات المشروع

موارد أخرى

ترحيل حلول Office إلى .NET Framework 4