التغييرات على تصميم مشاريع Office التي تستهدف .NET Framework 4
Visual Studio 2010 يقدم بعض التغييرات لتصميم مشاريع Office التي تستهدف .NET Framework 4. إذا كنت تألف مشاريع Office في الإصدارات السابقة من Visual Studio ، يجب أن تكون على علم بهذه التغييرات قبل تطوير مشاريع Office التي تستهدف .NET Framework 4. إذا كان لديك مشروع موجود تريد تحديثه ليستهدف .NET Framework 4, فهناك العديد من تغييرات API الجذرية التي يجب أن تكون على علم بها.
فهم التصميم المستند إلى الواجهة الجديد الخاص بأدوات Visual Studio لوقت تشغيل Office
عند تطويرك لمشروع Office يستهدف .NET Framework 4 ، معظم الأنواع التي تستخدمها في Visual Studio Tools لـ Office Runtime هي واجهات. هذا تغيير رئيسي عن الإصدارات السابقة الخاصة بــ Visual Studio Tools لوقت تشغيل Office ، حيث كانت هذه الأنواع فئات. على سبيل المثال، عند استهدافك .NET Framework 4 ، تكون الأنواع Worksheet و Document واجهات بدلاً من فئات. لمزيد من المعلومات، راجع نظرة عامة حول أدوات Visual Studio لوقت تشغيل Office.
بالنسبة لأي أنواع يمكنك إنشاء مثيل لها مباشرة في الإصدارات السابقة من Visual Studio Tools لوقت تشغيل Office ، الآن تقوم باستخدام أساليب الكائن Globals.Factory للحصول على مثيلات هذه الأنواع. على سبيل المثال، للحصول على كائن يطبق الواجهة SmartTag، استخدم الأسلوب Globals.Factory.CreateSmartTag . لمزيد من المعلومات، راجع ترحيل حلول Office إلى .NET Framework 4.
الفئات الأساسية الجديدة في مشاريع Office
التصميم المستند إلى الواجهة الجديدة من Visual Studio Tools لـ Office Runtime يؤثر على الفئات التي تم إنشاؤها في مشاريع Office مثل ThisDocument ، ThisWorkbook ، و ThisAddIn. في مشاريع Office التي تستهدف .NET Framework 3.5 والإصدارات السابقة من إطار العمل ، هذه الفئات التي تم إنشاؤها يتم اشتقاقها من الفئات في Visual Studio Tools لوقت تشغيل Office مثل Microsoft.Office.Tools.Word.Document ، و Microsoft.Office.Tools.Excel.Worksheet ، و Microsoft.Office.Tools.AddIn. في المشاريع التي تستهدف .NET Framework 4, هذه الفئات Visual Studio Tools لوقت تشغيل Office أصبحت الآن واجهات. وبالتالي لا يمكن للفئات المنشأة في مشاريع Office أن يتم اشتقاق التطبيق الخاص بها منها . بدلاً من ذلك ، يتم اشتقاق الفئات المنشأة من الفئات الأساسية الجديدة مثل DocumentBase و WorksheetBase ، و AddInBase. للمزيد من المعلومات، راجع برمجة وظائف إضافية على مستوى التطبيق وبرمجة تخصيصات علي مستوي مستند.
الفئات الأساسية ليست جزءاً من Visual Studio Tools لوقت تشغيل Office القابلة لإعادة التوزيع. بدلاً من ذلك، يتم تعريفها في تجميعات الأدوات المساعدة التي تُضمَّن Visual Studio 2010. هذه التجميعات يتم نسخها إلى مجلد الإخراج عند إنشاء مشاريع Office و يجب نشرها مع الحل الخاص بك. لمزيد من المعلومات حول تجميعات الأدوات المساعدة، راجع التجميعات في أدوات Visual Studio الخاصة بوقت تشغيل Office.
تغييرات API الجذرية في مشاريع Office التي تستهدف .NET Framework 4
يسرد الجدول التالي بعض التغييرات الجذرية الرئيسية في مشاريع Office التي تستهدف .NET Framework 4.
تغيير التعليمات البرمجية |
النتائج. |
|---|---|
لم يعد SecurityTransparentAttribute يتم استخدامها أو دعمها في مشاريع Office . |
يجب إزالة هذه السمة من ملف التعليمات البرمجية AssemblyInfo في مشاريع Office التي تقوم بترقيتها من 2008 Visual Studio. لمزيد من المعلومات، راجع إزالة السمات القديمة من مشاريع Office التي قمت أنت بترحيلها إلى .NET Framework 4. |
لم يعد ExcelLocale1033Attribute يتم استخدامها أو دعمها في مشاريع Excel . |
يجب عليك إزالة هذه السمة من ملف التعليمات البرمجية AssemblyInfo في مشاريع Excel. لمزيد من المعلومات، راجع إزالة السمات القديمة من مشاريع Office التي قمت أنت بترحيلها إلى .NET Framework 4. |
نموذج برمجة عناصر المشروع الشريط (مصمم مرئى) قد تغير. |
يجب تعديل ملف التعليمات البرمجية الخلفى لأي عناصر شريط في المشروع الخاص بك. يجب عليك تعديل أي تعليمات برمجية أيضاً تقوم بإنشاء مثيل عناصر تحكم "الشريط" في وقت التشغيل أو تقوم بمعالجة أحداث الشريط أو تقوم بتعيين موضع مكون الشريط برمجياً. لمزيد من المعلومات، راجع تحديث تخصيصات الشريط في مشاريع Office التي تقوم بترحيلها إلى .NET Framework 4. |
نموذج برمجة مناطق نموذج Outlook قد تغير. |
يجب تعديل الملف التعليمات البرمجية الخلفية لأي مناطق نموذج في مشروعك وفي أية تعليمات برمجية تقوم بإنشاء مثيل لفئات منطقة النموذج معينة في وقت التشغيل. لمزيد من المعلومات، راجع تحديث مناطق نموذج في مشاريع Outlook تقوم أنت بترحيلها إلى NET Framework 4.. |
نموذج برمجة العلامات الذكية في مشاريع Word وExcel قد تغير . |
يجب عليك تعديل أي تعليمات برمجية تنشئ علامة ذكية و كائنات إجراءات و التعليمات البرمجية التي تعرف أداة تعرُّف العلامة الذكية المخصصة . لمزيد من المعلومات، راجع تحديث مشاريع Word و Excel التي تقوم بترحيلها إلى .NET Framework 4. |
أساليب بناء جملة GetVstoObject و \ HasVstoObject قد تغيرت . |
يجب أن تمرر الآن الكائن Globals.Factory إلى هذه الأساليب عند الوصول إليها على الكائنات الأصلية من تجميعات التوافق الأساسية (PIAs) أو يمكنك الوصول إلى هذه الأساليب على الكائن الذي يتم إرجاعه بواسطة الخاصية Globals.Factory في المشروع الخاص بك. لمزيد من المعلومات، راجع تحديث مشاريع Word و Excel التي تقوم بترحيلها إلى .NET Framework 4. |
أحداث عناصر تحكم المحتوى الخاصة بـ Word مقترنة بمفوضين جدد. |
يجب عليك تعديل أية تعليمات برمجية تقوم بمعالجة أحداث عناصر تحكم المحتوى Word لتحديد مفوضين جدد. لمزيد من المعلومات، راجع تحديث مشاريع Word و Excel التي تقوم بترحيلها إلى .NET Framework 4. |
فئات OLEObject و OLEControl قد تم إعادة تسميتها . |
يجب عليك تعديل التعليمات البرمجية التي تستخدم مثيلات هذه الفئات لاستخدام كائنات Microsoft.Office.Tools.Excel.ControlSite أو Microsoft.Office.Tools.Word.ControlSite بدلاً من ذلك. لمزيد من المعلومات، راجع تحديث مشاريع Word و Excel التي تقوم بترحيلها إلى .NET Framework 4. |
راجع أيضًا:
المبادئ
نظرة عامة حول أدوات Visual Studio لوقت تشغيل Office