إضافة-في التسجيل

مقالة
11/01/2010

بعد إحدى الوظائف الإضافية هو التي تم إنشاؤها، يجب عليك regهوter به Visual Studioقبل تنشيطها في إدارة الوظائف الإضافية. Th هو هو accomplهوhed باستخدام ملف XML يحتوي على ملحق اسم ملف.addin.

.addin ملف يصف المعلومات التي Visual Studioيتطلب عرض الوظيفة الإضافية في إدارة الوظائف الإضافية. عند Visual Studioيبدأ، فإنه يبحث في.addin ملف الالموقع لأية.addin توفر ملف s. إذا وجد أي، يقوم بقراءة ملف XML ويعطي إدارة الوظائف الإضافية في المعلومات التي تتطلب لتبدأ في الوظيفة-في حالة هو النقر فوقه.

.addin ملف يتم إنشاؤه تلقائياً عندما تقوم بتاريخ الإنشاء وظيفة إضافية باستخدام معالج "الوظائف الإضافية". يمكنك أيضا إنشاء ملف.addin يدوياً باستخدام المعلومات الموجودة في هذا الموضوع.

ملف مواقع?

نسختين من.addin ملف يتم تلقائياً إنشاؤها بواسطة "معالج" الوظائف الإضافية، كما يلي:

.Addin ملف الالموقع	.Dll ملف الالموقع	الوصف
مجلد مشروع الجذر \مجلد مستندات\‏‫‏‫Visual Studio 2010\مشاريع\MyAddin1\MyAddin1\	مسار المحلي (MyAddin1.dll)	يستخدم للنشر من إضافة-في مشروع. مُضمن في مشروع لتسهيل التحرير والمسار المحلي لنمط XCopy توزيع.
إضافة-في مجلد \مجلد مستندات\‏‫‏‫Visual Studio 2010\الوظائف الإضافية\ -أو- الموقع مستندات المشتركة\‏‫Visual Studio 2010\الوظائف الإضافية\	مجلد تصحيح مشروع (على سبيل المثال،\My مستندات\Visual مشاريع\MyAddin1\MyAddin1\bin\Studio)	يستخدم لتشغيل إضافة-في بيئة التصحيح. يجب الإشارة دوماً إلى مسار إخراج تكوين الحالي للإنشاء.

مجلد مشروع الجذر

\مجلد مستندات\‏‫‏‫Visual Studio 2010\مشاريع\MyAddin1\MyAddin1\

مسار المحلي (MyAddin1.dll)

يستخدم للنشر من إضافة-في مشروع. مُضمن في مشروع لتسهيل التحرير والمسار المحلي لنمط XCopy توزيع.

إضافة-في مجلد

\مجلد مستندات\‏‫‏‫Visual Studio 2010\الوظائف الإضافية\

-أو-

الموقع مستندات المشتركة\‏‫Visual Studio 2010\الوظائف الإضافية\

مجلد تصحيح مشروع

(على سبيل المثال،\My مستندات\Visual مشاريع\MyAddin1\MyAddin1\bin\Studio)

يستخدم لتشغيل إضافة-في بيئة التصحيح. يجب الإشارة دوماً إلى مسار إخراج تكوين الحالي للإنشاء.

قم بتثبيت الوظيفة الإضافية تشغيل جهاز كمبيوتر آخر، يجب وضع الملف.addin في الموقع حيث يقوم ‏‫Visual Studio للوظائف الإضافية. يتم سرد هذه المواقع في صندوق الحوار خيارات ، في العقدة بيئة ، تشغيل إضافة-في/"الأمان وحدات الماكرو" الصفحة . للمزيد من المعلومات، راجع مربع حوار الخيارات, الأمان, بيئة, إضافة - في/ماكرو وإضافة-في الأمان.

ملف.dll الذي يحتوي تشغيل إضافة-تثبيت في أي مكان تشغيل الكمبيوتر العميل. على الرغم من ذلك، نوصي وضعه مع.addin ملف.

ملاحظة

<Assembly>يجب أن يشير عنصر في الملف.إضافةin إلى ملف.dll الذي يحتوي على الملفات الثنائية إضافة-بوصة

.Addin ملف

ملف XML.addin هو تقسيم في الأقسام ذات العلامات التالية:

القسم	الوصف
تطبيق مضيف	(مطلوب). تعيين أسماء وأرقام إصدارات التطبيقات التي يمكن تحميلها إضافة-في.
addin	(مطلوب) يحتوي على العناصر التي تصف إضافة-في.
أدوات خيارات الصفحة	(اختياري) تحديد صفحة في صندوق الحوار خيارات الموقع إضافة-في يمكن تكوينها. تحديد العقد التابعة للفئات والفئات الفرعية من الصفحة خيارات، وكذلك تجميع الخاصة به الاسم وكامل اسم فئة.

يلي عناصر يتم الأطفال من <Addin>مقطع:

العنصر	الوصف
حول تفاصيل صندوق	(Optional) Specifies the text that will be displayed for your add-in in the Visual Studio About dialog box.
حول رمز البيانات	(Optional) Contains binary data that specifies the icon that will be displayed for your add-in in the Visual Studio About dialog box.
حول الموقع رمز	(Optional) Specifies the absolute path or relative path of the icon that will be displayed for your add-in in the Visual Studio About dialog box.
المجموعة	(مطلوب). تحديد الالموقع إضافة-في الثنائيات. يمكن تعيين هذا الحقل إلى مسار محلي أو مسار شبكة اتصال أو عنوان URL.
الأمر خط اﻷمن	(اختياري) تعين Visual Studioالأوضاع التي الوظيفة الإضافية هو متوافقة، على سبيل المثال، سطر الأوامر فقط، المتكاملة (IDE) لبيئة التطوير-فقط، أو كليهما.
Preload الأمر	(اختياري) التي تم تحميلها مسبقاً بتعيين الحالة للوظيفة الإضافية؛ التي هو، وما إذا كانت الوظيفة الإضافية عليك إنشاء واجهة المستخدم الخاصة به باستخدام أسلوب مثل Commands.AddNamedCommand.
اسم فئة كاملة	(مطلوب). تعين اسم الفئة التي هو المستخدمة للاتصال بالوظيفة الإضافية.
سلوك تحميل	(اختياري) يحدد ما إذا كانت الوظيفة الإضافية هو تحميل عند بدء التشغيل أو يدوياً.

فيما يلي تفاصيل كل إعداد. لمزيد من المعلومات حول الموقع الهرمي العديد من العناصر التي تم وصفها، راجع ".Addin مثال XML ملف" لاحقاً في هذا الموضوع.

تطبيق مضيف

<Name>عنصر في Host Applicationمقطع يحتوي على اسم تطبيق. هذا هو الاسم الذي يتم عرضه في شريط عنوان الخاص تطبيق أو يتم إرجاعها بواسطة DTE.Name. على سبيل المثال، ل Visual Studioوقد تحتوي على علامة "Microsoft ‏‫Visual Studio" والنسبة IDE لوحدات الماكرو، قد تحتوي على علامة "وحدات Microsoft ‏‫Visual Studio الماكرو".

يمكن أن يكون هناك المزيد القيمة "تطبيق مضيف" في ملف.addin. يجب أن تكون كل القيمة bracketed باستخدام <Name>علامات في <HostApplication>عنصر. في الإضافة إلى contaفيفيg <Name>العنصر، كل <HostApplication>عنصر يجب أيضا في clude bracketed رقم الإصدار الخاص بالتطبيق بواسطة <Version>علامات. على سبيل المثال،

   <HostApplication>
      <!-- First Host App name (required). -->
      <Name>Microsoft Visual Studio</Name>
      <Version>10.0</Version>
   </HostApplication>
   <HostApplication>
      <!-- An additional supported program/version. -->
      <Name>Microsoft Visual Studio Macros</Name>
      <Version>10.0</Version>
   </HostApplication>

بدلاً من ذلك، يمكنك تحديد على علامة النجمة (*) (*) لتمثيل القيمة <Version>لأي الإصدار من Visual Studio.

اسم مألوف

<FriendlyName>العنصر، الذي هو الموجودة ضمن <Addin>العناصر، وتعيين السلسلة التي سيتم dهوplayed في العمود زر 'Ins' الإضافية متوفر من إدارة. على سبيل المثال،

   <FriendlyName>My New Super Addin</FriendlyName>

الوصف

<Description>العنصر، الذي هو الموجودة ضمن <Addin>العناصر، وتعيين السلسلة التي سيتم dهوplayed في صندوق الوصف في إدارة. على سبيل المثال،

   <Description>This add-in will change your life!</Description>

حول تفاصيل صندوق

إذا قمت بتحديد خيار لتوليد إعدادات ل حول صندوق حوار عندما تقوم بتوليد وظيفة الإضافية، يتم إضافة هذا العنصر إلى الملف.addin. This element specifies the text that will be displayed in the Visual Studio About dialog box. على سبيل المثال،

   <AboutBoxDetails>For add-in support, call 1-800-xxx-
     xxxx.</AboutBoxDetails>

حول رمز البيانات

إذا قمت بتحديد خيار لتوليد إعدادات ل حول صندوق حوار عندما تقوم بتوليد وظيفة الإضافية، يتم إضافة هذا العنصر إلى الملف.addin. This element contains binary data that specifies the icon that will be displayed in the Visual Studio About dialog box. على سبيل المثال،

<AboutIconData>0000010006 . . . FFFF0000</AboutIconData>

المجموعة

The <Assembly> عنصر, which هو located under the <Addin> عنصر, specifies the الموقع of the إضافة-في ثنائي ملفات. This عنصر can be التعيين إلى a نسبي مسار, an مطلق مسار ("ملف"), a مسجَّل اسم تجميع ("تجميع"), أو a URL ("url").

The following مثال shows an مطلق مسار الموقع. في this حالة, the src معلمة هو التعيين إلى file إلى indicate the الموقع of the إضافة-في DLL.
```
<Assembly src="file">C:\Documents and Settings\jdoe\Application Data\Microsoft\Visual Studio\10.0\AddIns\MyAddin4.dll</Assembly>
```
The following مثال shows a مسجَّل الموقع. في this حالة, the src معلمة هو التعيين إلى assembly إلى indicate a مسجَّل إضافة-في DLL.
```
<Assembly src="assembly">BookshelfDefineAddin</Assembly>
```
The following مثال shows a URL الموقع. في this حالة, the src معلمة هو التعيين إلى url إلى indicate the ويب-based الموقع of the إضافة-في DLL.
```
<Assembly src="url">http://somewebsite.com/MyAddin4.dll</Assembly>
```

اسم فئة كاملة

<FullClassName>العنصر بتحديد الاسم الكامل للفئة التي هو المستخدمة للاتصال بالوظيفة الإضافية الأداة وهذا يتضمن مساحة الاسم الذي يحتوي على فئة. على سبيل المثال،

    <FullClassName>MyAddin4.Connect</FullClassName>

سلوك تحميل

<LoadBehavior>يعرف عنصر ما إذا كانت الوظيفة الإضافية هو يتم تحميله تلقائياً عند بدء تشغيل IDE أو هو بدء تشغيلها يدوياً. <LoadBehavior>عنصر هو ضمن <Addin>العنصر. على سبيل المثال،

    <LoadBehavior>1</LoadBehavior>

على الرغم من أن استخدام <LoadBehavior>هو اختيارية، نوصي أن تستخدمها لتعريف واضح عند على الوظيفة الإضافية التحميلات.

Value	الوصف
0	الوظيفة الإضافية هو عدم تم تحميلهها عند بدء تشغيل IDE ويجب تشغيلها يدوياً.
1	الوظيفة الإضافية هو تحميلها تلقائياً عند بدء تشغيل IDE.
4	الوظيفة الإضافية هو تم تحميله متى devenv هو بدء تشغيل تعجيل الأوامر باستخدام رمز تبديل بنية ( devenv /build).

Preload الأمر

<CommandPreload>تحديد عنصر ما إذا كان إضافة-في يجب أن يكون التي تم تحميلها مسبقاً. تحميل preloading الوظيفة-في أول مرة ذلك Visual Studioبدء تشغيل بعد.addin ملف مثبت. على سبيل المثال،

    <CommandPreload>1</CommandPreload>

Th هو عنصر يتيح لك تحديد أن وظيفة إضافية يجب تم تحميله بعد Visual Studioهو بدأ. يعطي الوظيفة الإضافية فرصة لإنشاء عناصر واجهة المستخدم المطلوبة مثل الأزرار شريط الأوامر، أو تنفيذ البعض أول المهام فقط تهيئة-الوقت-مثل إنشاء افتراضي الإعدادات الإضافية. إضافة-في هو ثم تم إلغاء تحميلها حتى يقوم مستخدم بتنفيذ واحد الأوامر التي إضافة-إنشاء. بعد ذلك، الوظيفة الإضافية هو تحميلها حسب الحاجة.

Value	الوصف
0	الوظيفة الإضافية لم يتم تحميل حتى يقوم مستخدم أما بتشغيله باستخدام إدارة الوظائف الإضافية أو الوظيفة الإضافية هو تعيين تحميل عند بدء التشغيل.
1	الوظيفة الإضافية يتم تحميله تلقائياً عندما Visual Studioبدء التشغيل لأول مرة بعد.addin ملف مثبت.

يمكنك فحص من OnConnectionالطريقة التي يتم بها تنفيذ لمعرفة ما إذا كان نوع الاتصال، الذي هو المحدد باستخدام وسيطة ثانية إلى OnConnection، هو ext_cm_UISetup. إذا كان ذلك هو، يمكنك القيام بأي placements الأمر الذي تريده باستخدام أما AddNamedCommandأو AddControlالأسلوب.

الأمر خط اﻷمن

اختياري <CommandLineSafe>عنصر يشير إلى ما إذا كانت الوظيفة الإضافية صممت لتجنب dهوplaying واجهة مستخدم عند ذلك هو بدء تشغيل تعجيل الأوامر، على سبيل المثال، عند إجراء الإنشاء سطر الأوامر أو العمليات المشابهة. (Th هو هو القيام بتحديد الوظائف الإضافية الخاصة بي إلى عدم وضع عن عدم إظهار مربعات الحوار المشروطة في الوظيفة الإضافية لمعالج.) أيضا، وهي تحدد Visual Studioأوضاع معه الوظيفة الإضافية هو متوافق، على سبيل المثال، الأوامر-سطر فقط أو IDE فقط. على سبيل المثال،

    <CommandLineSafe>0</CommandLineSafe>

Value	الوصف
0	تعين التي الوظيفة الإضافية هو سطر الأوامر غير اﻷمن وقد dهوplay واجهة مستخدم.
1	تعين التي الوظيفة الإضافية هو الأمن سطر الأوامر وعدم dهوplay واجهة مستخدم.

أدوات خيارات الصفحة

اختياري <ToolsOptionsPage>تحديد عنصر خيارات الصفحة بحيث يمكن للمستخدمين تكوين إضافة-في. حدد العقد التابعة للفئة و فئة الفرعية التي تظهر الصفحة، و اسم تجميع و اسم فئة كامل الصفحة خيارات. يلي مثال عرض هيكلي لهذا العنصر:

  <ToolsOptionsPage>
    <Category Name="Text Editor">
      <SubCategory Name="General">
        <Assembly>"MyFilePath\MyAddInOptionPage.dll"</Assembly>
        <FullClassName>"MyNamespace.MyAddInOptionPage"</FullClassName>
      </SubCategory>
    </Category>
  </ToolsOptionsPage>

مثال.Addin ملف XML

يلي مثال يظهر ملف XML.addin كاملة. يشير هذا هيكلي و المواقع للعناصر التي تم وصفها في هذا الموضوع.

<?xml version="1.0" encoding="UTF-16" standalone="no"?>
<Extensibility 
  xmlns="https://schemas.microsoft.com/AutomationExtensibility">
    <HostApplication>
        <Name>Microsoft Visual Studio Macros</Name>
        <Version>10.0</Version>
    </HostApplication> 
    <HostApplication>
        <Name>Microsoft Visual Studio</Name>
        <Version>10.0</Version>
    </HostApplication>
    <Addin>
        <FriendlyName>My great new add-in.</FriendlyName>
        <Description>This add-in does it all.</Description>
        <AboutBoxDetails>Copyright 2010.</AboutBoxDetails>
        <AboutIconData>0000 . . . FFFF0000</AboutIconData>
        <Assembly>MyNewAddin.dll</Assembly>
        <FullClassName>MyNewAddin.Connect</FullClassName>
        <LoadBehavior>1</LoadBehavior>
        <CommandPreload>1</CommandPreload>
        <CommandLineSafe>0</CommandLineSafe>
    </Addin>
</Extensibility>

راجع أيضًا:

مشاركة عبر