Udostępnij za pośrednictwem

Dodaj w rejestracji

  • Artykuł

Po dodatek jest tworzony, należy rejestr go z Visual Studio przed aktywowaniem w - W Menedżerze.Można to osiągnąć za pomocą pliku XML , który marozszerzenie nazwa pliku.addin.

Plik .addin zawiera opis informacji, Visual Studio wymaga, aby wyświetlić dodatek w - W Menedżerze.Gdy Visual Studio jest uruchamiana, szuka w lokalizacji pliku .addin dla wszelkich plików dostępnych .addin.Jeśli stwierdzi, że dowolne, odczytuje plik XML i daje - W Menedżerze informacji wymaga, aby rozpocząć dodatek po kliknięciu.

Plik .addin jest tworzone automatycznie podczas utworzyć dodatek za pomocą kreatora Dodaj.Można również utworzyć plik .addin ręcznie przy użyciu informacji w tym temacie.

Lokalizacje plików

Dwie kopie pliku .addin są tworzone automatycznie przez kreatora Add-In w następujący sposób:

.Lokalizacja pliku dodatek

.Lokalizacja pliku dll

Opis

Głównym folderem projekt

\Dokumenty\ 2010\Projects\MyAddin1\MyAddin1\Visual Studio

Ścieżka lokalna (MyAddin1.dll)

Używany do wdrażanie dodatek projekt.Włączone do projekt w celu ułatwienia edycji i ma ścieżkę lokalną do stylu XCopy wdrażanie.

Dodaj w folderze

\Dokumenty\ 2010\Addins\Visual Studio

- lub -

Lokalizacja dokumentów udostępnionych\Addins\

Folder debugować projektu

(Na przykład \ Documents\Visual Studio 2010

Projects\MyAddin1\MyAddin1\bin\)

Używane do uruchamiania dodatek debugowanie środowisko.Zawsze powinny wskazywać ścieżki wyjściowej bieżącej kompilacja konfiguracja.

Aby instalować dodatek na innym komputerze plik .addin umieszcza się w miejscu, gdzie Visual Studio sprawdza, czy dodatki.Te lokalizacje są wymienione w Opcje okno dialogowe, środowiska węzła, na zabezpieczeń w strony. Aby uzyskać więcej informacji, zobacz Dodawanie zabezpieczeń.

Plik dll, który zawiera dodatek można zainstalować dowolne miejsce na komputerze klienckim.Jednak zaleca się, aby umieścić w pliku .addin.

[!UWAGA]

<Assembly> Element plik .addin musi wskazywać na plik .dll, który zawiera pliki binarne dla dodatek.

.Dodatek do pliku

Plik XML .addin jest podzielony na następujące sekcje oznakowanych:

Sekcja

Opis

Aplikacja hosta

(Wymagane). Określa nazwy i numery wersji aplikacji, które można załadować dodatek.

Dodatek

(Wymagane) Zawiera elementy, które opisują dodatek.

Narzędzia Opcje strony

(Opcjonalnie) Określa stronę w Opcjeokno dialogowe , gdzie dodatek może być konfigurowane. Określić węzły podrzędne, kategorii i podkategorii Opcje stronę i także jego nazwę zestaw i pełną nazwa klasy.

Następujące elementy są dzieci <Addin> sekcji:

Element

Opis

O szczegółach pole

(Opcjonalnie) Określa tekst, który będzie wyświetlany dla użytkownika dodatek w Visual Studioookno dialogowe. 

Ikona dane — informacje

(Opcjonalnie) Zawiera dane dane binarne , które określa ikonę, która będzie wyświetlany dla użytkownika dodatek w Visual Studioookno dialogowe. 

O lokalizacji ikonę

(Opcjonalnie) Określa ścieżkę bezwzględną lub ścieżka względna ikony, który będzie wyświetlany dla użytkownika dodatek w Visual Studioookno dialogowe. 

Montaż

(Wymagane). Określa lokalizację plików binarnych dodatek .To pole można ustawić ścieżkę lokalną, ścieżkę sieć lub adres URL.

Bezpieczne wiersza polecenia

(Opcjonalnie) Określa Visual Studio tryby, z których dodatek jest zgodne, na przykład wiersza polecenia tylko, zintegrowanego rozwoju środowisko (IDE)-tylko, lub obu.

Polecenie Wczytaj wstępnie

(Opcjonalnie) Określa stan wstępnie dodatek; oznacza to, czy dodatek należy utworzyć jej interfejsu użytkownika za pomocą metoda , takie jak Commands.AddNamedCommand.

Pełna nazwa klasy

(Wymagane). Określa nazwę klasy, który jest używany do połączyć do dodatek.

Podczas ładowania

(Opcjonalnie) Określa, czy dodatek jest ładowany podczas uruchamiania lub ręcznie.

Poniżej przedstawiono szczegółowe informacje dla każdego ustawienie.Aby uzyskać więcej informacji o lokalizacji, hierarchiczną wiele elementów, które są opisane, zobacz "przykład.Dodatek do pliku XML w dalszej części tego tematu.

19dax6cz.collapse_all(pl-pl,VS.110).gifAplikacja hosta

<Name> Element w Host Application sekcji zawiera nazwę aplikacji.Jest to nazwa, która jest wyświetlana na pasek tytułu aplikacji lub jest zwracany przez DTE.Name.Na przykład, dla Visual Studio, tag zawierałaby "Microsoft Visual Studio" i makra, IDE, znacznik zawierałaby "Microsoft Visual Studio makra".

Może być więcej niż jedną wartość aplikacji hosta dla pliku .addin.Każda wartość musi być oddzielona za pomocą <Name> znaczników w <HostApplication> element.Oprócz zawierających <Name> element, co <HostApplication> elementu musi również zawierać numer wersji, stosowania oddzielona przez <Version> znaczniki.Na przykład,

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

Alternatywnie, można określić gwiazdkę (*) oznaczającą wartość dla <Version> dla dowolnej wersji programu Visual Studio.

19dax6cz.collapse_all(pl-pl,VS.110).gifPrzyjazna nazwa

<FriendlyName> Element, który znajduje się pod <Addin> element, określa ciąg, który będzie wyświetlany w Dostępne dodatki kolumny w - w Menedżerze.Na przykład,

   <FriendlyName>My New Super Addin</FriendlyName>

19dax6cz.collapse_all(pl-pl,VS.110).gifOpis

<Description> Element, który znajduje się pod <Addin> element, określa ciąg, który będzie wyświetlany w Opis polu - w Menedżerze.Na przykład,

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

19dax6cz.collapse_all(pl-pl,VS.110).gifO szczegółach pole

Jeśli zaznaczono opcję wygenerowania ustawień dla ookno dialogowe podczas utworzyć swoje dodatek, ten element jest dodawany do pliku .addin. Ten element Określa tekst, który będzie wyświetlany w Visual Studioookno dialogowe.  Na przykład,

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

19dax6cz.collapse_all(pl-pl,VS.110).gifIkona dane — informacje

Jeśli zaznaczono opcję wygenerowania ustawień dla ookno dialogowe podczas utworzyć swoje dodatek, ten element jest dodawany do pliku .addin. Element ten zawiera dane dane binarne , które określa ikonę, która będzie wyświetlana w Visual Studioookno dialogowe.  Na przykład,

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

19dax6cz.collapse_all(pl-pl,VS.110).gifMontaż

<Assembly> Element, który znajduje się pod <Addin> element, określa lokalizację dodatekplikidane binarne . Ten element można ustawić ścieżka względna, ścieżką bezwzględną ("plik"), nazwę zarejestrowanego zestaw ("zestaw") lub adres URL ("adres url").

  • Poniższy przykład pokazuje lokalizację ścieżki bezwzględnej.W tym przypadku src parametr jest ustawiony na file do wskazywania położenia dodatek bibliotece DLL.

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

  • Poniższy przykład pokazuje zarejestrowanych lokalizacji.W tym przypadku src parametr jest ustawiony na assembly do wskazania zarejestrowanych dodatek biblioteki DLL.

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

  • Poniższy przykład pokazuje lokalizacji adres URL .W tym przypadku src parametr jest ustawiony na url do wskazania sieć Web-oparte lokalizacji dodatek bibliotece DLL.

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

19dax6cz.collapse_all(pl-pl,VS.110).gifPełna nazwa klasy

<FullClassName> Element Określa imię i nazwisko klasy, który jest używany do połączyć do dodatek.Obejmuje to przestrzeń nazw zawierający klasy.Na przykład,

    <FullClassName>MyAddin4.Connect</FullClassName>

19dax6cz.collapse_all(pl-pl,VS.110).gifPodczas ładowania

<LoadBehavior> Element definiuje, czy dodatek jest ładowany automatycznie przy uruchamianiu IDE lub jest uruchamiany ręcznie.<LoadBehavior> Element znajduje się pod <Addin> element.Na przykład,

    <LoadBehavior>1</LoadBehavior>

Chociaż użycie <LoadBehavior> jest opcjonalna, zaleca się używać jawnie zdefiniować, kiedy dodatek ładuje.

Wartość

Opis

0

dodatek nie jest ładowany podczas uruchamiania IDE i musi zostać uruchomione ręcznie.

1

dodatek jest automatycznie ładowany podczas uruchamiania IDE.

4

dodatek jest ładowany podczas uruchamiania devenv w wierszu polecenia przy użyciu przełącznika kompilacja (devenv /build).

19dax6cz.collapse_all(pl-pl,VS.110).gifPolecenie Wczytaj wstępnie

<CommandPreload> Element określa, czy dodatek musi być załadowane.Obciążenia wstępnego ładuje dodatek pierwszy czasu Visual Studio jest uruchamiany po zainstalowaniu pliku .addin.Na przykład,

    <CommandPreload>1</CommandPreload>

Ten element pozwala określić, że dodatek musi być załadowany po Visual Studio jest uruchomiona.Podaje swoje dodatek szansę utworzyć wymagane elementy interfejsu użytkownika, takie jak przyciski paska poleceń lub wykonywać inne zadania inicjowania pierwszy czasu tylko takie jak tworzenie domyślne ustawienia dodatek .dodatek jest następnie rozładowane, dopóki użytkownik wykonuje się jedno z poleceń, utworzone dodatek .Następnie dodatek jest ładowany w razie potrzeby.

Wartość

Opis

0

dodatek nie ładuje aż użytkownik uruchamia go za pomocą - W Menedżerze lub dodatek jest ustawiony do ładowania podczas uruchamiania.

1

dodatek jest ładowany automatycznie po Visual Studio rozpoczyna się po raz pierwszy po zainstalowaniu pliku .addin.

Można sprawdzić OnConnection metoda wdrożenia do Zobacz czy typ połączenia, która jest określona przy użyciu drugiego argument do OnConnection, jest ext_cm_UISetup. Jeśli jest, można wykonywać niezależnie od miejsca docelowe polecenia, używając albo AddNamedCommand lub AddControl metoda.

19dax6cz.collapse_all(pl-pl,VS.110).gifBezpieczne wiersza polecenia

Opcjonalny <CommandLineSafe> element wskazuje, czy dodatek został zaprojektowany w celu uniknięcia wyświetlania interfejsu użytkownika po uruchomieniu wiersza polecenia, na przykład podczas wykonywania wiersza polecenia kompilacje lub podobnych operacji.(Jest to realizowane przez zaznaczenie Mój dodatek nigdy nie wprowadzi modalny interfejsu użytkownika w kreatora Add-in.) Ponadto określa Visual Studio tryby na przykład polecenia-wiersza tylko lub IDE, który dodatek jest zgodny tylko.Na przykład,

    <CommandLineSafe>0</CommandLineSafe>

Wartość

Opis

0

Określa, że dodatek nie jest bezpiecznym wiersza polecenia, a interfejsu użytkownika mogą być wyświetlane.

1

Określa, że dodatek jest bezpiecznym wiersza polecenia, a nie wyświetla interfejsu użytkownika.

19dax6cz.collapse_all(pl-pl,VS.110).gifNarzędzia Opcje strony

Opcjonalny <ToolsOptionsPage> określa element Opcje strony, dzięki czemu użytkownicy mogą skonfigurować dodatek.Określić węzły podrzędne, kategorii i podkategorii, która pojawi się Strona, oraz nazwę zestaw i pełną nazwa klasy Opcje strony.Hierarchia tego elementu można znaleźć w poniższym przykładzie:

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

Przykład.Dodatek do pliku XML

W poniższym przykładzie przedstawiono plik XML pełną .addin.To pokazuje hierarchię i lokalizacji dla elementów, które są opisane w tym temacie.

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

Zobacz też

Zadania

Jak: dodatki formantu przy użyciu dodać Menedżera

Jak: Tworzenie dodatku

Instruktaż: Tworzenie kreatora

Informacje

Visual Studio poleceń i przełączników

Koncepcje

Wykres modelu obiektu automatyzacji

Inne zasoby

Tworzenie dodatków i kreatorów