متطلبات تطوير خط أنابيب
لتمكين مقاطع خطوط الأنابيب و إضافة-أدوات لكي يتم اكتشافها وتنشيطه، يجب أن تتوافق مع نطاق المحدد والسمات ومتطلبات بنية الدليل.
خط أنابيب الأجزاء و التجميعات
زر 'Ins' الإضافية، العقود، و طرق العرض يجب أن يكون عاماً. محولات و يمكن الداخلية المنشئات الخاصة بهم.
بشكل عام، يتم تضمين مقاطع خطوط الأنابيب داخل تجميع الخاصة بها ولكن يمكنك يجمع المقاطع التالية في نفس تجميع:
طرق عرض للوظائف الإضافية الخاصة باستضافة و إضافة في-جانب طرق العرض.
محولات مضيف من جانب و إضافة في جانب محولات.
يمكنك يجمع مضيف و إضافة في جانب محولات في نفس تجميع فقط إذا قمت أيضا بضم طرق العرض في نفس تجميع.
إذا قمت بضم قطعة تشغيل جانب واحد من خط أنابيب مع النسخة المطابقة له الموجودة تشغيل الجانب الآخر من خط أنابيب، مثل طرق العرض مضيف من إضافة-زر 'Ins' مع إضافة-في طرق العرض، يجب نشر هذا تجميع لكلا الجانبين لخط أنابيب لهذا المقطع.
إذا كنت لا تجميعها بطرق العرض في نفس تجميع، يمكنك يجمع مضيف بعرض مضيف إضافة-في نفس تجميع.
متطلبات السمة
طلب قطع أنابيب التالية السمات تشغيل الفئات التي تعرف عليها:
إضافة-تتطلب وظائف AddInAttribute.
تتطلب العقود AddInContractAttribute.
إضافة-في طرق العرض تتطلب AddInBaseAttribute.
تتطلب إضافة في جانب محولات AddInAdapterAttribute.
تتطلب محولات جانب مضيف HostAdapterAttribute.
لا يتطلب عرض مضيف الوظيفة-في مقطع خط أنابيب سمة لأنه يتم تمرير الكائن إلى AddInStore.FindAddIns(Type, String, array<String[])الأسلوب، ولذلك لا يلزم أن يكون اكتشاف.
يظهر التوضيح التالي أجزاء خط أنابيب مع الخاصة بهم مطلوب السمات.
طراز الوظيفة الإضافية مع مطلوب السمات تشغيل أنواع
.png "نموذج الوظيفة الإضافية التي تحتوي على السمات المطلوبة بالأنواع.")
متطلبات الدليل خطوط الأنابيب
ل .NET Frameworkلاكتشاف مقاطع خطوط الأنابيب وتنشيط إضافة-الوظائف، وخطوط الأنابيب يجب أن يكون وضع القطع في الدليل المحدد. تكون أسماء الدليل المحدد مطلوب ولكنها ليست حساسة لحالة الأحرف. تكون الأسماء الوحيدة التي لم يتم تحديد اسم الدليل الجذر أنابيب (الذي قمت بتوفير طرق الاكتشاف)، وأسماء الدلائل الفرعية التي تحتوي على إضافة-زر 'Ins'. يجب أن تكون الجميع أسماء قطعة معينة الدلائل الفرعية تشغيل نفس المستوى أسفل الجذر خطوط الأنابيب.
يبين المثال التالي هذه المتطلبات في الدليل.
مطلوب الدلائل ل إضافة-في تطوير
.png "الدلائل المطلوبة لتطوير الوظيفة الإضافية.")
يصف الجدول التالي مطلوب بنية الدليل.
الدليل |
الوصف |
|---|---|
جذر خط أنابيب |
الدليل الذي يحتوي على الدلائل الفرعية الخاصة قطع خط الأنابيب. هناك هو لا يوجد اسم مطلوب لترتيب هو الدليل وأنه يمكن أن يكون في أي مكان. مثال: ..\Pipeline |
الوظائف الإضافية |
اختياري. الدليل الذي يحتوي على الدلائل الفرعية أو أكثر، كل منها يحتوي إضافة-في. يجب تسمية هذا الدليل الوظائف الإضافية. مثال: ..\Pipeline\AddIns يمكنك جعل إضافة-وظائف في أماكن غير ذلك في النظام. |
AddInSideAdapters |
الدليل الذي يحتوي على إضافة-في-جانب محولات تجميع. يجب تسمية هذا الدليل من AddInSideAdapters. مثال: ..\Pipeline\AddInSideAdapters |
AddInViews |
الدليل الذي يحتوي على إضافة-في تجميع طرق العرض. يجب تسمية هذا الدليل من AddInViews. مثال: ..\Pipeline\AddInViews |
العقود |
الدليل الذي يحتوي على تجميع العقود. يجب تسمية هذا الدليل الاسم "عقود". مثال: ..\Pipeline\Contracts |
HostSideAdapters |
الدليل الذي يحتوي على تجميع محولات جانب مضيف. يجب تسمية هذا الدليل من HostSideAdapters. مثال: ..\Pipeline\HostSideAdapters |
AddInStore.Updateو AddInStore.Rebuildأن وظائف التحميلات الزائدة تأخذ متغير سلسلة يمثل جذر خط أنابيب، أو PipelineStoreLocationالقيمة. اكتشاف هذه الأساليب متوفر إضافة-وخط أنابيب الأجزاء في النظام والحفاظ على المعلومات المخزنة مؤقتاً في مخزن معلومات. ل المزيد من المعلومات حول وظائف الاكتشاف، راجع إضافة-اكتشاف في.
تطبيق مضيف وعرض مضيف إضافة-في مقطع خط أنابيب يتم نشرها بشكل عام في نفس الدليل، والذي يمكن أن يكون في أي مكان. يتطلب التطبيق المضيف مرجع لعرض المضيف إضافة-في القطعة التي تمثل إضافة-في تنشيط.
يمكن أن تكون خط أنابيب في أي مكان، بما في ذلك داخل بنية الدليل الحل الخاص بك Visual Studio. يجب نسخ قطع خط أنابيب إلى الدلائل الخاصة بهم في خط أنابيب. تم تصميم direcإلىry خط أنابيب وبه subdirecإلىries إلى تحتوي على خطوط أنابيب متعددة. لمزيد من المعلومات حول متعددة pipelines سيناريوهات، راجع إضافة-في وحدات سيناريو خط أنابيب.
إضافة-وظائف في مواقع? غير ذلك
غير مطلوبة لجعل إضافة-وظائف في بنية الدليل خطوط الأنابيب. إذا لم تكن موجودة في بنية دليل خطوط الأنابيب، يجب استدعاء AddInStore.UpdateAddInsأسلوب أو RebuildAddInsالأسلوب الذي يأخذ مسار إلى الدليل الذي يحتوي على الصفحة إضافة-وظائف كمعلمة الخاصة به.
يمكنك أيضا تضمين addInPathsمعلمة عند استدعاء AddInStore.FindAddInsأسلوب.
إذا كان تطبيق مضيف الخاص بك يعلم المسارات وأسماء نوع الكامل الخاص به إضافة-زر 'Ins'، يمكن استخدام FindAddInطريقة للعثور تشغيل محدد إضافة-في تجنب الاستعلامات تشغيل بنية الدليل خطوط الأنابيب. ومع ذلك، بنية الدليل خطوط أنابيب مطلوب لا يزال.
مراجع مقطع خط أنابيب في Visual Studio
عند إضافة مرجع في مشروع لقطعة خط أنابيب آخر، مثل محول الوظيفة في جانب تتطلب مرجع إلى المقطع اتفاق، قم بإجراء مرجع إلى المشروع الخاص بتلك القطعة بدلاً من تجميع الخاص به. في هذا المثال، ستكون المرجع إلى مشروع اتفاق. مرجع مشروع يمنع تجميعات المشار إليه من التي يتم نشرها إلى خط أنابيب، والذي يمكن أن يؤدي إلى حدوث تعارضات. كما يتم منع التعارضات بعدم نسخ الملفات محلياً.
لإضافة مرجع مشروع
في من مستكشف الحل، ينقر على اليمين مراجع مجلد و اختيار إضافة مرجع.
في التبويب مشاريع ، حدد مشروع الذي تريده وانقر فوق موافق .
Under the مراجع مجلد, انقر the مشروع مرجع you just تمت الإضافة.
في the مرجع خصائص, التعيين نسخ محلي إلى خطأ.
مطلوب مراجع
The following جدول lists the pipeline segments that require تجميع مراجع إلى النظام.AddIn.dll و النظام.اتفاق.dll. Some segments also require مراجع إلى غير ذلك compiled segments.
قطعة خط أنابيب |
تجميع و مراجع مشروع? |
مساحة الاسم و نوع مراجع |
|---|---|---|
عقد |
النظام.AddIn.dll النظام.AddIn.اتفاق.dll |
النظام.AddIn.Pipeline النظام.AddIn.اتفاق |
إضافة-في العرض |
النظام.AddIn.dll |
النظام.AddIn.Pipeline |
إضافة في-جانب محول |
النظام.AddIn.dll النظام.AddIn.اتفاق.dll إضافة-في عرض segment اتفاق segment |
النظام.AddIn.Pipeline |
جانب مضيف محول |
النظام.AddIn.dll النظام.AddIn.اتفاق.dll مضيف عرض segment اتفاق segment |
النظام.AddIn.Pipeline |
مضيف |
النظام.AddIn.dll مضيف عرض segment |
النظام.AddIn.Hosting مضيف عرض |
الوظيفة الإضافية |
النظام.AddIn.dll إضافة-في عرض segment |
النظام.AddIn إضافة-في عرض |
The host عرض of the إضافة-in has لا مرجع requirements but it هو مطلوب for the تطبيق مضيف.
نشر إلى خط أنابيب في Visual Studio
Visual Studio، يمكنك إنشاء مقاطع خطوط الأنابيب في بنية الدليل خطوط الأنابيب بواسطة تغيير مسار. إنشاء الإخراج
إلى نشر إلى خط أنابيب في Visual Studio
من قائمة أدوات ، أشر إلى مشروع الخاص بك خصائص و ثم حدد التبويب بنية.
قم بتغيير مسار إخراج قطع خط أنابيب إلى الدلائل الخاصة بهم في بنية الدليل خطوط الأنابيب.
The تطبيق مضيف و the host عرض are typically deployed in the same الدليل. يمكن في أي الموقع الدليل خط أنابيب ولكن عادة ما يكون هو في نفس الدليل كـ التطبيق مضيف.