Registrace

Článek
03/04/2013

Vytvořený doplněk se musíte registr s Visual Studio dříve, než může být aktivováno v Správce doplňků.To lze provést pomocí souboru jazyk XML , který má název souboru.addinpřípona.

Soubor .addin obsahuje informace, Visual Studio vyžaduje zobrazení doplněk v Správce doplňků.Při Visual Studio se spustí, vypadá umístění souboru .addin pro všechny soubory k dispozici .addin.Pokud najde všechny, přečte soubor jazyk XML a poskytuje Správce doplňků informace vyžaduje spuštění doplněk po klepnutí.

.Addin soubor je automaticky vytvořen při vytvořit doplněk pomocí průvodce přidat.Můžete také vytvořit soubor .addin ručně pomocí informace v tomto tématu.

Umístění souborů

Dvě kopie souboru .addin jsou automaticky vytvořené pomocí průvodce přidat takto:

.Doplněk umístění souboru	.Umístění souboru DLL	Description
Kořenové složky projekt \Dokumentů\ 2010\Projects\MyAddin1\MyAddin1\Visual Studio	Místní cesta (MyAddin1.dll)	Slouží k nasazení doplněk projekt.Součástí projekt pro snadné úpravy a má místní cestu pro styl XCopy nasazení.
Přidat do složky \Dokumentů\ 2010\Addins\Visual Studio -nebo- Sdílené umístění dokumentů\Addins\	ladit složky projektu (Například \ Documents\Visual Studio 2010 Projects\MyAddin1\MyAddin1\bin\)	Používá pro spuštění doplněk ladění prostředí.Vždy směřovat výstupní cesta aktuální sestavení konfigurace.

Kořenové složky projekt

\Dokumentů\ 2010\Projects\MyAddin1\MyAddin1\Visual Studio

Místní cesta (MyAddin1.dll)

Slouží k nasazení doplněk projekt.Součástí projekt pro snadné úpravy a má místní cestu pro styl XCopy nasazení.

Přidat do složky

\Dokumentů\ 2010\Addins\Visual Studio

-nebo-

Sdílené umístění dokumentů\Addins\

ladit složky projektu

(Například \ Documents\Visual Studio 2010

Projects\MyAddin1\MyAddin1\bin\)

Používá pro spuštění doplněk ladění prostředí.Vždy směřovat výstupní cesta aktuální sestavení konfigurace.

K nainstalovat doplněk v jiném počítači musí být umístěna v souboru .addin v místě, kde Visual Studio hledá doplňky.Tato umístění jsou uvedeny v Možnosti dialog, v prostředí uzel, Přidat zabezpečení stránku. Další informace naleznete v tématu Zabezpečení.

Soubor dll, který obsahuje doplněk lze instalovat do libovolného klientského počítače.Doporučujeme však vložit pomocí souboru .addin.

[!POZNÁMKA]

<Assembly> Prvek souboru .addin musí odkazovat na soubor dll, která obsahuje binární doplněk.

Na.Doplněk souboru

Soubor jazyk XML .addin je rozděleno do následujících částech s příznakem:

Oddíl	Description
Hostitelské aplikace	(Požadováno). Určuje názvy a čísla verze aplikací, které lze načíst doplněk.
Doplněk	(Požadováno) Obsahuje prvky, které popisují doplněk.
Stránka Možnosti nástroje	(Volitelné) Určuje stránku Možnostidialog , kde doplněk lze konfigurovat. Podřízené uzly určit kategorie a podkategorie Možnosti stránky a také její název sestavení a název celé třída .

Následující prvky se děti <Addin> oddíl:

Element	Description
O podrobnosti pole	(Volitelné) Určuje text zobrazený pro vaše doplněk v Visual Studioodialog.
Ikona data	(Volitelné) Obsahuje binary data, která určuje ikonu, která se zobrazí v doplněk v Visual Studioodialog.
O umístění ikony	(Volitelné) Určuje absolutní cesta nebo relativní cesta ikonu, která se zobrazí v doplněk v Visual Studioodialog.
Sestavení	(Požadováno). Určuje umístění binární doplněk .Toto pole můžete nastavit místní cestu, síť nebo URL.
Bezpečné příkazového řádku	(Volitelné) Určuje, Visual Studio režimy, které doplněk je kompatibilní, je například příkaz-čára pouze integrované vývojové prostředí (IDE)-pouze, nebo obojí.
Příkaz Načíst	(Volitelné) Určuje stav předem doplněk; zda doplněk by vytvořit jeho uživatelského rozhraní pomocí metoda jako Commands.AddNamedCommand.
Úplný název třídy	(Požadováno). Určuje název třída , která se používá k připojit doplněk.
Chování při načítání.	(Volitelné) Definuje, zda doplněk načten při spuštění nebo ručně.

Zde jsou podrobnosti pro každé nastavení.Další informace o hierarchické umístění řadu prvků, které jsou popsány v tématu "příklad.Doplněk souboru jazyk XML dále v tomto tématu.

Hostitelské aplikace

<Name> Prvek Host Application část obsahuje název aplikace.Toto je název, který je zobrazen na záhlaví aplikace nebo vrácené DTE.Name.Například pro Visual Studio, tag by "Microsoft Visual Studio" a maker IDE tag by obsahovat Visual Studio makra Microsoft".

Může existovat více než jednu hodnotu hostitelské aplikaci .addin soubor.Každá hodnota musí být bracketed pomocí <Name> tagy v <HostApplication> prvku.Kromě <Name> prvek, každý <HostApplication> prvku musí zahrnovat také číslo verze aplikace bracketed podle <Version> značky.Příklad:

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

Můžete také zadat hvězdičku (*) představuje hodnotu pro <Version> pro všechny verze Visual Studio.

Popisný název

<FriendlyName> Prvek, který je umístěn pod <Addin> prvek určuje řetězec, který se zobrazí v Dostupné doplňky ve sloupci Správce doplňků.Příklad:

   <FriendlyName>My New Super Addin</FriendlyName>

Description

<Description> Prvek, který je umístěn pod <Addin> prvek určuje řetězec, který se zobrazí v Popis ve Správce doplňků.Příklad:

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

O podrobnosti pole

Pokud vyberete možnost generování nastavení odialog při vytvořit vašeho doplněk, tento prvek je přidán do souboru .addin. Tento prvek určuje text, který se zobrazí v Visual Studioodialog. Příklad:

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

Ikona data

Pokud vyberete možnost generování nastavení odialog při vytvořit vašeho doplněk, tento prvek je přidán do souboru .addin. Tento prvek obsahuje binary data, která určuje ikonu, zobrazí se v Visual Studioodialog. Příklad:

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

Sestavení

<Assembly> Prvek, který je umístěn pod <Addin> prvek, určuje umístění doplněkbinary soubory. Tento prvek může být nastavena na relativní cesta, absolutní cestu ("soubor"), název registrované sestavení ("sestavení") nebo URL ("url").

Následující příklad ukazuje absolutní umístění.V tomto případě src parametr nastaven na file k označení umístění doplněk knihovny DLL.
```
<Assembly src="file">C:\Documents and Settings\jdoe\Application Data\Microsoft\Visual Studio\10.0\AddIns\MyAddin4.dll</Assembly>
```
Následující příklad ukazuje registrované umístění.V tomto případě src parametr nastaven na assembly k označení registrované doplněk DLL.
```
<Assembly src="assembly">BookshelfDefineAddin</Assembly>
```
Následující příklad ukazuje umístění URL .V tomto případě src parametr nastaven na url označuje web-podle umístění doplněk knihovny DLL.
```
<Assembly src="url">http://somewebsite.com/MyAddin4.dll</Assembly>
```

Úplný název třídy

<FullClassName> jméno a příjmení třída , která se používá k připojit doplněkurčuje prvek.obor názvů obsahující třídapatří.Příklad:

    <FullClassName>MyAddin4.Connect</FullClassName>

Chování při načítání.

<LoadBehavior> Prvek definuje, zda doplněk je zaveden automaticky při spuštění IDE nebo ruční spuštění.<LoadBehavior> Prvkem je pod <Addin> prvku.Příklad:

    <LoadBehavior>1</LoadBehavior>

Ačkoli využití <LoadBehavior> je volitelný, doporučujeme použít explicitně definovat, kdy doplněk načte.

Value	Description
0	doplněk není načten při spuštění IDE a musí být spuštěna ručně.
1	doplněk je automaticky načten při spuštění IDE.
4	doplněk je načten při spuštění příkazového řádku devenv pomocí přepínače sestavení (devenv /build).

Příkaz Načíst

<CommandPreload> Prvek určuje, zda doplněk musí být zavedené.Načte předpínacím doplněk první čas, který Visual Studio je spuštěna po instalaci souboru .addin.Příklad:

    <CommandPreload>1</CommandPreload>

Tento prvek umožňuje určit, že doplněk musí být načten po Visual Studio je spuštěna.Poskytuje vaše doplněk šanci vytvořit požadované prvky uživatelského rozhraní, jako je například panelu příkazů nebo provádění jiných úkolů inicializace první času jen jako je například vytváření výchozích nastavení doplněk .Klepněte doplněk je uvolněn, dokud uživatel provede jeden z příkazů, které doplněk vytvořen.Poté doplněk načten podle potřeby.

Value	Description
0	doplněk nenačte dokud jej uživatel spustí pomocí Správce doplňků doplněk je nebo načíst při spuštění.
1	doplněk je načteny automaticky při Visual Studio spustí poprvé po instalaci souboru .addin.

Můžete zkontrolovat OnConnection metoda implementaci viz zda typ připojení, který je určen druhý argument OnConnection, je ext_cm_UISetup. Je-li, můžete provést jakékoli příkaz stáže, buď pomocí AddNamedCommand nebo AddControl metoda.

Bezpečné příkazového řádku

Nepovinný <CommandLineSafe> prvku označuje, zda doplněk byl navržen zabránit zobrazení uživatelského rozhraní při spuštění příkazového řádku, například při provádění příkazu-vytvoříčára nebo podobných operací.(To se provádí výběrem Tento doplněk nebude nikdy do modální uživatelského rozhraní v Přidat Průvodce.) Určuje také Visual Studio režimy, které doplněk je kompatibilní, například, příkazovéhočára-pouze nebo pouze IDE.Příklad:

    <CommandLineSafe>0</CommandLineSafe>

Value	Description
0	Určuje, že doplněk není příkazovéhočára bezpečné a může zobrazit uživatelské rozhraní.
1	Určuje, že doplněk je příkazovýčára bezpečné a nezobrazuje žádné uživatelské rozhraní.

Stránka Možnosti nástroje

Nepovinný <ToolsOptionsPage> určuje prvek Možnosti stránky tak, aby uživatelé mohou konfigurovat doplněk.Podřízené uzly určit kategorie a podkategorie, zobrazené stránky, název sestavení a název celé třída Možnosti stránku.Následující příklad ukazuje hierarchii tento prvek:

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

Příklad.Doplněk souboru jazyk XML

Následující příklad ukazuje soubor jazyk XML úplné .addin.Zobrazuje hierarchii a umístění pro prvky, které jsou popsány v tomto tématu.

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

Viz také

Sdílet prostřednictvím