إضافة-اكتشاف في

يمكن أن تكتشف التطبيقات مضيف إضافة-زر 'Ins' متوفر لهم. اكتشاف يتكون من الثاني المهام:

• Registering information about all إضافة-زر 'Ins' و pipeline segments into ذاكرة تخزين مؤقت ملفات.

• يتم الآن البحث عن إضافة-أدوات لعرض مضيف معين من إضافة-في بيتم الآن البحث في ذاكرة تخزين مؤقت.

استناداً إلى تطبيق مضيف عادة dهوcovers زر 'Ins' الإضافية عند بدء التشغيل وعند مستند هو تم تحميلهها، أو بناء تشغيل طلب مستخدم. AddInStoreتوفر الفئة وظائف لتنفيذ هذه المهام.

بمجرد أن تم اكتشافها إضافة-زر 'Ins'، يمكنك تنشيط عليها كما هو موضح في تنشيط الوظائف الإضافيةو كيفية القيام بما يلي: تنشيط إضافة-زر 'Ins' بعزل مختلفة ومستويات الأمان.

Registering إضافة-زر 'Ins' و Pipeline Segments

Registering involves determining valid إضافة-زر 'Ins' by يتم الآن التدقيق the attributes of pipeline segments و constructing information about their pipelines. For more information about applying attributes إلى pipeline segments و creating the pipeline الدليل بنية, see متطلبات تطوير خط أنابيب. يمكن أن تحتوي بنية الدليل أنابيب خطوط أنابيب أو أكثر. ذاكرة التخزين المؤقت هذه المعلومات في ملفي في خط أنابيب الدليل الجذر: PipelineSegments.store و الوظائف الإضافية.store.

تأخذ الأساليب المستخدمة لتسجيل متغير سلسلة يمثل مسار الجذري المستمر، أو القيمة من PipelineStoreLocationقائمة تعداد. تاريخ الإنشاء جديد ذاكرة تخزين مؤقت الملفات إذا كانت هذه الملفات لم يتم مسبقاً تاريخ الإنشاء.

الطرق اعادة تجميع أو تحديث ذاكرة تخزين مؤقت للملفات، كـ يوضح الجدول التالي.

أسلوب تسجيل	الوصف
Rebuild	يقوم برنامج إعادة إنشاء ذاكرة تخزين مؤقت لقطع خطوط الأنابيب يتضمن أي جديد الإضافات. يقوم برنامج إعادة هذا الأسلوب أيضا إنشاء إضافة-وظائف ذاكرة تخزين مؤقت إذا إضافة-وظائف موجودة داخل بنية الالدليل خط أنابيب.
RebuildAddIns	يقوم برنامج إعادة إنشاء إضافة-وظائف ذاكرة تخزين مؤقت ل إضافة-الوظائف في الموقع معين. استدعاء هذا الأسلوب إذا كان إضافة-من وظائف خارج بنية الدليل خطوط الأنابيب.
Update	قطع خط أنابيب ذاكرة تخزين مؤقت مع التحديثات أي الإضافات. هذا الأسلوب أيضا تحديث إضافة-وظائف ذاكرة تخزين مؤقت إذا إضافة-وظائف موجودة داخل بنية الالدليل خط أنابيب. إذا كان هناك لا قطع خط أنابيب جديد أو إضافة-من زر 'Ins'، هذا الأسلوب مجرد صحة ذاكرة تخزين مؤقت.
UpdateAddIns	قم بتحديث ذاكرة التخزين المؤقتة الوظيفة الإضافية لأي جديد زر 'زر 'Ins'' الإضافية في الموقع معين. استدعاء هذا الأسلوب إذا كان إضافة-من وظائف خارج بنية الدليل خطوط الأنابيب. If there are لا جديد إضافة-زر 'Ins' installed, this أسلوب simply validates the ذاكرة تخزين مؤقت.

Rebuildو Updateأخذ كمعلمة أسلوب التحميلات الزائدة أما الدليل الجذر بنية الدليل قناة أو قيمة من PipelineStoreLocationالتعداد.

These وظائف استخدم انعكاس-فقط تحميل إلى obtain معلومات و do not تشغيل the إضافة-في's تعليمات برمجية أو the pipeline segment's تعليمات برمجية. Cached معلومات هو الوقت-stamped so that it ليس recomputed during تحديثات.

ذاكرة تخزين مؤقت ملفات

The النتيجة of calling the تسجيل وظائف are الثاني ذاكرة تخزين مؤقت ملفات:

• PipelineSegments.store

  This ملف هو located في the جذر الدليل of the pipeline الدليل بنية.

• الوظائف الإضافية.store

  This ملف هو located في the الدليل that يحتوي على واحد أو المزيد إضافة-في subdirectories. This الدليل can be within the pipeline الدليل بنية أو at another الموقع.

Finding إضافة-زر 'Ins'

FindAddInsأسلوب فحص ملفات المخزن للبحث عن الجميع إضافة-زر 'Ins' التي تتوافق مع طريقة عرض مضيف معين من إضافة-بوصة مضيف عرض الوظيفة الإضافية هو فئة مجردة الأساسية أو واجهة تصف الأساليب المستخدمة من قبل مضيف والوظيفة الإضافية، كما هو محدد في اتفاق. إلى العثور على ملفات ذاكرة تخزين مؤقت تم إنشاؤها بواسطة وظائف تسجيل، ويتخذ هذا الأسلوب كمعلمة أما direcإلىry الجذري لبنية direcإلىry أنابيب أو القيمة من PipelineStoreLocationالتعداد.

ملاحظة
باستدعاء FindAddInsفقط بعد التأكد من أن الملفات مخزن بناء وتحديث حيث توفر الجميع إضافة-يمكن العثور على أدوات.

FindAddInsإرجاع الأسلوب IList<T>مجموعة من الرموز المميزة التي تصف توفر كل إضافة-بحيث يحتوي على خط أنابيب صالحة. الرمز المميز لكل هو هو موضح بواسطة AddInTokenفئة.

كل رمز يحتوي تشغيل المعلومات التالية حول وظيفة-فيه، هو تم الحصول عليها من AddInAttributeالسمة تشغيل الفئة للوظيفة الإضافية:

• الاسم

• الوصف

• الناشر

• Version

في معظم الحالات، هو رمز واحد فقط في IList<T>مجموعة. إذا كان هناك هو المزيد الرمز المميز، تطبيق مضيف يمكن استخدام ترتيب هو معلومات لمساعدة مستخدم تحديد الوظيفة الإضافية للتنشيط. للحصول على مزيد من المعلومات حول تنشيط، راجع تنشيط الوظائف الإضافية.

للبحث عن إضافة-وظائف خارج بنية الدليل خط أنابيب، يجب عليك تضمين AddInPathsمعلمة. لأن th هو معلمة هو صفيفة من سلاسل، يمكنك تحديد مواقع? متعددة.

يمكنك أيضا العثور على محدد إضافة-مع FindAddInالطريقة التي تقوم بإرجاع مجموعة من رمز واحد.

المثال

يوضح المثال التالي كيف إلى بنية ذاكرة تخزين مؤقت للملفات والبحث عن زر 'زر 'Ins'' الإضافية.

' Get the path for the pipeline root.  
' Assumes that the current directory is the
' pipline directory structure root directory.
Dim pipeRoot As String = Environment.CurrentDirectory
' Update the cache files of the
' pipeline segments and add-ins.
Dim warnings() As String = AddInStore.Update(pipeRoot)
For Each warning As String In warnings
    Console.WriteLine(warning)
Next

' Search for add-ins of type Calculator (the host view of the add-in)
' specifying the host's application base, instead of a path,
' for the FindAddIns method.
Dim tokens As Collection(Of AddInToken) = _
    AddInStore.FindAddIns(GetType(Calculator), PipelineStoreLocation.ApplicationBase)

// Get path for the pipeline root.
// Assumes that the current directory is the  
// pipeline directory structure root directory. 
String pipeRoot = Environment.CurrentDirectory;

// Update the cache files of the
// pipeline segments and add-ins.
string[] warnings = AddInStore.Update(pipeRoot);

foreach (string warning in warnings)
{
    Console.WriteLine(warning);
}

// Search for add-ins of type Calculator (the host view of the add-in)
// specifying the host's application base, instead of a path,
// for the FindAddIns method.

Collection<AddInToken> tokens = 
            AddInStore.FindAddIns(typeof(Calculator),PipelineStoreLocation.ApplicationBase);

راجع أيضًا:

المبادئ

الإضافات و القابلية للتوسعة

تنشيط الوظائف الإضافية

متطلبات تطوير خط أنابيب

عقود وطرق العرض، و محولات