Eklenti Kaydı

Visual Studio eklentileri, Visual Studio 2013'te kullanım dışıdır.Eklentilerinizi VSPackage uzantılarına yükseltmelisiniz.Yükseltme hakkında daha fazla bilgi için bkz: SSS: Eklentileri VSPackage Uzantılarına Dönüştürme.

Bir eklenti oluşturulduktan sonra kendisiyle kaydetmelisiniz Visual Studio içinde etkinleştirilmeden önce Eklenti Yöneticisi.Bu, bir .addin dosya adı uzantısına sahip bir XML dosyası kullanarak gerçekleştirilir.

.Addin dosya bilgilerini açıklar, Visual Studio içinde görüntülemek için gerektirir Eklenti Yöneticisi.Zaman Visual Studio başlatır, görünüyor kullanılabilir .addin dosyaları için .addin dosya konumda.Bu herhangi bulunursa, XML dosyasını okur ve verir Eklenti Yöneticisi gerektirir eklenti tıklatıldığında başlatmak için bilgi.

Bir eklenti Eklenti Sihirbazı'nı kullanarak oluşturduğunuzda .addin dosya otomatik olarak oluşturulur.Bu konudaki bilgiler kullanarak .addin dosya el ile de oluşturabilirsiniz.

Dosya konumları

.Addin dosyasının iki kopyası Eklenti Sihirbazı tarafından otomatik olarak şekilde oluşturulur:

Eklenti başka bir bilgisayara yüklemek için .addin dosya burada Visual Studio için eklentiler denetler bir konumda yerleştirilmelidir.Bu konumları listelenen seçenekleri iletişim kutusunda ortam düğüm, eklenti güvenlik sayfa.Daha fazla bilgi için bkz. Eklenti Güvenliği.

Eklenti içeren .dll dosyasını herhangi bir istemci bilgisayarında yüklenebilir.Ancak, .addin dosyayla put öneririz.

[!NOT]

<Assembly> .Addin dosyasının öğesi eklenti için ikili dosyalarını içeren .dll dosyası noktadan gerekir.

.Eklenti dosyası

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

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

Her bir ayarın ayrıntıları aşağıdadır.Birçok açıklanan, öğelerin hiyerarşik konumu hakkında daha fazla bilgi için "örnek bakın.Daha sonra bu konudaki eklentisi XML dosyası".

Konak uygulama

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

.Addin dosya başına birden fazla konak uygulama değer olabilir.Her bir değeri kullanarak bracketed gerekir <Name> bulunan etiketleri <HostApplication> öğesi.Ek olarak içeren bir <Name> öğesi, her <HostApplication> öğesi tarafından parantezli uygulamanın sürüm numarasını da içermelidir <Version> etiketler.Örneğin,

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

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

Kolay adı

<FriendlyName> Altında bulunan öğesi, <Addin> öğesi görüntülenecektir dize belirtir kullanılabilir eklentiler sütununda Eklenti Yöneticisi.Örneğin,

   <FriendlyName>My New Super Addin</FriendlyName>

Açıklama

<Description> Altında bulunan öğesi, <Addin> öğesi görüntülenecektir dize belirtir açıklama kutusunda Eklenti Yöneticisi.Örneğin,

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

Hakkında kutusunu ayrıntıları

Ayarlarını oluşturmak için seçeneğini seçerseniz hakkında iletişim kutusu eklentinizi oluşturduğunuzda, bu öğe .addin dosyasına eklenir.This element specifies the text that will be displayed in the Visual Studio About dialog box.Örneğin,

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

Simge verileri hakkında

Ayarlarını oluşturmak için seçeneğini seçerseniz hakkında iletişim kutusu eklentinizi oluşturduğunuzda, bu öğe .addin dosyasına eklenir.This element contains binary data that specifies the icon that will be displayed in the Visual Studio About dialog box.Örneğin,

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

Derleme

<Assembly> Altında bulunan öğesi, <Addin> öğesi, eklenti ikili dosyalarının konumunu belirtir.Bu öğe bir göreli yol, bir mutlak yol ("dosyası"), bir kayıtlı derleme adı ("derleme") veya bir URL için ayarlanabilir ("url").

• Aşağıdaki örnek, bir mutlak yol konumu gösterir.Bu durumda, src parametresi ayarlandığında file eklenti DLL konumu belirtmek için.

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

• Aşağıdaki örnek, kayıtlı bir konum gösterir.Bu durumda, src parametresi ayarlandığında assembly kayıtlı bir eklenti DLL belirtmek için.

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

• Aşağıdaki örnek, bir URL konumu gösterir.Bu durumda, src parametresi ayarlandığında url eklenti DLL Web tabanlı konumu belirtmek için.

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

Tam sınıf adı

<FullClassName> Öğesi tam eklenti bağlanmak için kullanılan sınıfın adını belirtir.Bu sınıf içeren ad alanı içerir.Örneğin,

    <FullClassName>MyAddin4.Connect</FullClassName>

Yükleme 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> Öğesidir altında <Addin> öğesi.Örneğin,

    <LoadBehavior>1</LoadBehavior>

Olsa da kullanımını <LoadBehavior> açıkça ne zaman bir eklenti yükler tanımlamak için kullanmanızı öneririz isteğe bağlıdır.

Komut Preload

<CommandPreload> Öğesi eklenti önceden yüklü gerekir olup olmadığını belirtir.Önceden yüklenmesi yükleri eklenti ilk kez Visual Studio .addin dosya yüklendikten sonra başlatılır.Örneğin,

    <CommandPreload>1</CommandPreload>

Bu öğe bir eklenti sonra yüklenmesi gerektiğini belirtmenize olanak tanır Visual Studio başlatılır.Bu eklentiyi komut çubuğu düğmeleri gibi gerekli kullanıcı Arabirimi öğelerini oluşturmak veya varsayılan ayarları eklenti oluşturma gibi diğer ilk-yalnızca zamanla başlatma görevleri gerçekleştirmek için bir fırsat verir.Eklenti ise bir kullanıcı bir eklenti oluşturulan komut yürütür kadar kaldırıldı.Bundan sonra eklentiyi gerektiği gibi yüklenir.

Kontrol edebilirsiniz OnConnection görmek için uygulayan yöntemi olup olmadığını ikinci bağımsız değişkeni'ni kullanarak belirtilen bağlantı türü OnConnection, olan ext_cm_UISetup.İse, hangi komutu yerleşimi istediğiniz kullanarak gerçekleştirebileceğiniz AddNamedCommand veya AddControl yöntemi.

Komut satırı güvenli

İsteğe bağlı <CommandLineSafe> öğesi eklenti bir kullanıcı Arabirimi, komut satırı yapılar veya benzer bir işlem gerçekleştirilirken bir komut isteminde, örneğin, başlatıldığında görüntüleme önlemek için tasarlanmıştır olup olmadığını gösterir.(Bu seçerek yapılır benim eklenti hiçbir zaman kalıcı bir kullanıcı Arabirimi koyacaktır içinde Eklenti Sihirbazı.) Ayrıca, belirtir Visual Studio modları eklenti uyumlu olduğu, örneğin, komut-satırı yalnızca veya IDE yalnızca.Örneğin,

    <CommandLineSafe>0</CommandLineSafe>

Araçlar Seçenekler sayfası

İsteğe bağlı <ToolsOptionsPage> öğesi belirten bir seçenekleri kullanıcılar eklenti yapılandırabilir, böylece sayfa.Alt düğümleri kategori sayfasında, görünen alt kategori ve derleme adı ve tam sınıf adını belirtin seçenekleri sayfa.Aşağıdaki örnek, bu öğenin hiyerarşi gösterir:

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

Örnek.XML dosyası eklentisi

Aşağıdaki örnek, bir tam .addin XML dosyası gösterir.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</Name>
        <Version>12.0</Version>
    </HostApplication> 
    <HostApplication>
        <Name>Microsoft Visual Studio</Name>
        <Version>11.0</Version>
    </HostApplication>
    <Addin>
        <FriendlyName>My great new add-in.</FriendlyName>
        <Description>This add-in does it all.</Description>
        <AboutBoxDetails>Copyright 2013.</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: Eklenti Yöneticisini Kullanarak Eklentileri Denetleme

Nasıl yapılır: Eklentiler Oluşturma

İzlenecek yol: Sihirbaz Oluşturma

Kavramlar

Otomasyon Nesne Modeli Grafiği

Diğer Kaynaklar

Eklentiler ve Sihirbazlar Oluşturma

Visual Studio Komutları ve Anahtarları