Aracılığıyla paylaş

Eklenti kayıt

  • Makale

Bir eklenti oluşturulduktan sonra, onu Eklenti Yöneticisi'nde etkinleştirilmeden önce Visual Studio belirtecine kaydetmelisiniz.Bu, .addin dosya adıuzantısahip bir XML dosyası kullanılarak gerçekleştirilir.

.addin dosyası, Visual Studio uygulamasının eklentileri Add-In Managerda görüntüleyebilmesi için ihtiyaç duyduğu bilgileri açıklar.Visual Studio başladığında, kullanılabilir .addin dosyaları için .addin dosya konumuna bakar.Herhangi bulursa, XML dosyasını okur ve verir Add-In Manager eklenti tıklatıldığında başlamasını istediği bilgiler.

.addin dosyası, Eklenti Sihirbazı'nı kullanarak bir eklenti yarattığınızda otomatik olarak oluşturulur.Ayrıca bir .addin dosyası oluşturmak ' ni el ile bu konudaki bilgileri kullanarak yapabilirsiniz.

Dosya konumları

.addin dosyasının iki kopyası Eklenti Sihirbazı tarafından, otomatik olarak aşağıdaki gibi oluşturulur:

.Addin Dosya Konumu

.Dll Dosya Konumu

Description

Kök proje klasörü

\Documents\Visual Studio 2010\Projects\MyAddin1\MyAddin1\

Yerel yol (MyAddin1.dll)

Eklenti projesinin dağıtımı için kullanılır.Projeye düzenleme kolaylığı sağlamak için dahil edilmiştir ve XCopy tarzı dağıtımının yerel yolu vardır.

Eklenti klasörü

\Documents\Visual Studio 2010\Addins\

-veya-

Paylaşılan Belgeler Konumu\Addins\

Proje hata ayıklama klasörü

(Örneğin, \ Documents\Visual Studio 2010

Projects\MyAddin1\MyAddin1\bin\)

Eklentinin hata ayıklama ortamında çalıştırılması için kullanılır.Her zaman geçerli yapı yapılandırmasının çıktı yolunu göstermelidir.

eklenti başka bir bilgisayara takmak için .addin dosyasını Visual Studio için eklentiler burada denetler bir konumda yerleştirilmelidir.Bu konumları listelenen seçenekleri iletişim kutusu, ortam düğüm, eklentisi güvenlik sayfa. Daha fazla bilgi için bkz. Güvenlik eklentisi.

eklenti içeren .dll dosyasının herhangi bir istemci bilgisayara yüklenebilir.Ancak, .addin dosyasıyla koymak öneririz.

[!NOT]

<Assembly> .Addin dosyasının öğesi içeren eklentiiçin ikili dosyalar .dll dosyasını göstermelidir.

.Eklenti dosyası

.Addin XML dosyası aşağıdaki etiketli bölümlere ayrılır:

Bölüm

Description

Ana bilgisayar uygulaması

(Gerekli) eklentiyükleyebilirsiniz uygulamalar sürüm numaraları ve adları belirtir.

Eklentisi

(Gerekli) eklentitanımlayan öğeleri içerir.

Araçlar Seçenekler sayfa

(İsteğe bağlı) Bir sayfayı belirtir seçenekleriiletişim kutusu burada eklenti yapılandırılabilir. kategori ve alt kategori, alt düğümler belirtmek seçenekleri sayfa ve ayrıca, derleme adı ve tam sınıf adı.

Aşağıdaki öğeleri, alt, <Addin> bölümü:

Öge

Description

Hakkında kutusu ayrıntıları

(İsteğe bağlı) Sizin eklenti görüntülenecek metni belirtir Visual Studiohakkındailetişim kutusu. 

Simge verileri hakkında

(İsteğe bağlı) Bilgisayarınıza eklenti içinde görüntülenen simgeyi belirtir ikili veri içeren Visual Studiohakkındailetişim kutusu. 

Simge konumları hakkında

(İsteğe bağlı) Mutlak bir yol veya göreli yol , eklenti içinde görüntülenen simgeyi belirtir Visual Studiohakkındailetişim kutusu. 

Derleme

(Gerekli) eklenti ikili dosyaların konumunu belirtir.Bu alan , yerel bir yol, bir ağ yolu veya URLiçin ayarlanabilir.

Komut satırı için güvenli

(İsteğe bağlı) Belirtir Visual Studio eklenti olduğu uyumlu, modları, komut-çizgi yalnızca tümleşik geliştirme ortam (IDE)-yalnızca, ya da her ikisi.

Komut Preload

(İsteğe bağlı) eklentiönceden durumunu belirtir; diğer bir deyişle olup eklenti oluşturmak kendi kullanıcı Arabirimi gibi bir yöntem kullanarak gereken Commands.AddNamedCommand.

Tam sınıf adı

(Gerekli) eklentiolarak bağlamak için kullanılan sınıf adını belirtir.

Yükle davranışı

(İsteğe bağlı) Bir eklenti başlangıçta veya el ile yüklü olup olmadığını tanımlar.

Burada, her bir ayarayrıntılar bulunur.Hiyerarşik konumu hakkında daha fazla bilgi için açıklanan öğelerin çoğunu görmek "örnek.Eklenti XML dosyası"Bu konunun ilerisinde.

19dax6cz.collapse_all(tr-tr,VS.110).gifAna bilgisayar uygulaması

<Name> Öğesinde Host Application bölüm uygulamaadını içerir.Bu başlık çubuğu uygulama çubuğunda görüntülenen veya tarafından döndürülen ad, DTE.Name.Örneğin, Visual Studio, "Microsoft Visual Studio" etiketi içerecektir ve Macros IDE "Microsoft Visual Studio Macros" etiketi içerecektir.

.Addin dosya başına birden fazla ana bilgisayar uygulamasının değer olabilir.Her bir değeri kullanarak bracketed gerekir <Name> etiketleri <HostApplication> öğesi.İçeren ek olarak bir <Name> öğesi, her <HostApplication> öğesi tarafından bracketed uygulama sürüm numarasını da içermelidir <Version> etiketler.Örnek:

   <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>

Alternatif olarak, için değeri temsil etmek için yıldız işareti (*) belirtebilirsiniz <Version> , herhangi bir sürüm için Visual Studio.

19dax6cz.collapse_all(tr-tr,VS.110).gifYakın Ad

<FriendlyName> Altında bulunan öğe <Addin> öğesi içinde görüntülenen dize belirtir Kullanılabilen Eklentiler sütununda Add-in Manager.Örnek:

   <FriendlyName>My New Super Addin</FriendlyName>

19dax6cz.collapse_all(tr-tr,VS.110).gifDescription

<Description> Altında bulunan öğe <Addin> öğesi içinde görüntülenen dize belirtir Açıklama kutusunda Add-in Manager.Örnek:

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

19dax6cz.collapse_all(tr-tr,VS.110).gifHakkında kutusu ayrıntıları

Ayarları oluştur seçeneğini seçerseniz, hakkındailetişim kutusu oluşturmak , eklenti, bu öğe eklendiğinde için .addin dosyası. Bu öğe içinde görüntülenecek metni belirtir Visual Studiohakkındailetişim kutusu.  Örnek:

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

19dax6cz.collapse_all(tr-tr,VS.110).gifSimge verileri hakkında

Ayarları oluştur seçeneğini seçerseniz, hakkındailetişim kutusu oluşturmak , eklenti, bu öğe eklendiğinde için .addin dosyası. Bu öğe içinde görüntülenen simgeyi belirtir ikili veri içeren Visual Studiohakkındailetişim kutusu.  Örnek:

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

19dax6cz.collapse_all(tr-tr,VS.110).gifDerleme

<Assembly> Altında bulunan öğe <Addin> öğesi, eklentiikili dosyalarının konumunu belirtir. Bu öğe göreli yol, mutlak bir yol ("file"), kayıtlı derleme adı ("derleme") veya bir URL olarak ayarlanabilir ("url").

  • Aşağıdaki örnek, bir mutlak yol konumunu gösterir.Bu durumda, src parametre ayarlanmış file eklenti dll konumunu belirtmek için.

    <Assembly src="file">C:\Documents and Settings\jdoe\Application Data\Microsoft\Visual Studio\10.0\AddIns\MyAddin4.dll</Assembly>

  • Aşağıdaki örnek, kayıtlı bir konumu gösterir.Bu durumda, src parametre ayarlanmış assembly bir kayıtlı eklenti DLL'si belirtmek için.

    <Assembly src="assembly">BookshelfDefineAddin</Assembly>

  • Aşağıdaki örnek, bir URL konumunu gösterir.Bu durumda, src parametre ayarlanmış url Webbelirtmek için- eklenti dll konumunu dayalı.

    <Assembly src="url">http://somewebsite.com/MyAddin4.dll</Assembly>

19dax6cz.collapse_all(tr-tr,VS.110).gifTam sınıf adı

<FullClassName> Öğesi eklentiolarak bağlamak için kullanılan sınıf tam ad belirtir.Bu sınıfiçeren isim uzayı içerir.Örnek:

    <FullClassName>MyAddin4.Connect</FullClassName>

19dax6cz.collapse_all(tr-tr,VS.110).gifYükle davranışı

<LoadBehavior> Öğesi, bir eklenti IDE başlangıçta otomatik olarak yüklenir veya el ile başlatıldığında olup olmadığını tanımlar.<LoadBehavior> Öğedir altında <Addin> öğesi.Örnek:

    <LoadBehavior>1</LoadBehavior>

Ancak, kullanım <LoadBehavior> bir eklenti yüklediğinde açıkça tanımlamak için kullanmanızı öneririz isteğe bağlıdır.

Value

Description

0

eklenti IDE başlangıçta yüklü değil ve el ile başlatılması gerekir.

1

eklenti otomatik olarak IDE başlangıçta yüklenir.

4

eklenti Devenv yapı anahtarını kullanarak komut isteminden başlatıldığında yüklenen (devenv /build).

19dax6cz.collapse_all(tr-tr,VS.110).gifKomut Preload

<CommandPreload> Öğesi eklenti önceden gerekir olup olmadığını belirtir.Önceden yüklenmesi yükler eklenti ilk kez Visual Studio .addin dosya yüklendikten sonra başladı.Örnek:

    <CommandPreload>1</CommandPreload>

Bu öğe, bir eklenti sonra yüklenmesi gerektiğini belirlemenize izin verir Visual Studio başlatılır.Kendi eklenti komut çubuğu düğmelerini gibi gerekli oluşturmak kullanıcı Arabirimi öğeleri için bir şans verir veya eklenti ayarlarını varsayılan oluşturma gibi diğer ilk-zaman-yalnızca başlatma görevlerini gerçekleştirebilir.eklenti ise kullanıcı bir eklenti oluşturulan komut yürütür kadar kaldırıldı.Bundan sonra eklenti gerektiği gibi yüklenir.

Value

Description

0

kullanıcı tarafından kullanmaya başlayana kadar eklenti yüklemez Add-In Manager veya eklenti baþlangýçta yüklenmek üzere ayarlanır.

1

eklenti otomatik olarak ne zaman yüklenen Visual Studio .addin dosyasını yükledikten sonra ilk kez başlatır.

Kontrol edebilirsiniz OnConnectiongörmek için uygulamak yöntem olup olmadığını ikinci bağımsız değişken kullanarak belirtilen bağlantı türü, OnConnection, iş ext_cm_UISetup. İse, kullanarak istediğiniz ne olursa olsun komut yerleşimlerini gerçekleştirebilirsiniz AddNamedCommand veya AddControl yöntem.

19dax6cz.collapse_all(tr-tr,VS.110).gifKomut satırı için güvenli

İsteğe bağlı <CommandLineSafe> öğesi eklenti komutu gerçekleştir-çizgi oluşturur, bir komut isteminde, örneğin, başlatıldığında, kullanıcı Arabirimi ya da benzer işlemleri görüntüleme önlemek için tasarlanmış olup olmadığını gösterir.(Bu seçilerek yapılır Benim eklenti asla koymak kadar kalıcı bir UI , Add-in Wizard.) Ayrıca belirtir Visual Studio eklenti olduğu uyumlu, örneğin modları, komut -çizgi-yalnızca veya yalnızca IDE.Örnek:

    <CommandLineSafe>0</CommandLineSafe>

Value

Description

0

eklenti komutçizgi güvenli değildir ve bir kullanıcı Arabirimi görüntüleyebilir belirtir.

1

eklenti komutçizgi güvenli olduğunu ve bir UI görüntülenmez belirtir.

19dax6cz.collapse_all(tr-tr,VS.110).gifAraçlar Seçenekler sayfa

İsteğe bağlı <ToolsOptionsPage> öğesi belirtir bir seçenekleri kullanıcılar eklentiyapılandırabilir böylece sayfa.Alt düğümler, kategori ve sayfa yer alt kategori ve derleme adı ve tam sınıf adı belirtmek seçenekleri sayfa.Aşağıdaki örnek, bu öğe hiyerarşisini gösterir:

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

Örnek.XML dosya eklentisi

Tam .addin XML dosyasını aşağıdaki örnekte gösterilmektedir.Hiyerarşi ve konumları açıklanan öğeleri için bu konudaki gösterir.

<?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>

Ayrıca bkz.

Görevler

Nasıl yapılır: denetim Eklenti Yöneticisi'ni kullanarak eklentileri

Nasıl yapılır: bir eklenti oluşturmak

İzlenecek yol: bir sihirbaz oluşturma

Başvuru

Visual Studio komutları ve anahtarları

Kavramlar

Otomasyon nesne modeli şeması

Diğer Kaynaklar

Eklentiler ve sihirbazlar oluşturma