Návod: Vytváření spravovaných satelitních knihoven DLL

  • Článek

Ve verzi vs_dev12 jsou zastaralé doplňky.Doporučujeme upgradovat doplňky na rozšíření VSPackage.Další informace o upgradu najdete v tématu Nejčastější dotazy: Převádění doplňků na rozšíření VSPackage.

Satelitní knihovny DLL jsou užitečné pro ukládání souborů prostředků, například ikon, bitmap a zdrojových řetězců v centrálním umístění pro doplňky a jiné projekty automatizace.Satelitní knihovny DLL lze opakovaně využít pro jiné projekty nebo doplňky.Kromě toho oddělení řetězců a dalších prostředků z vašeho doplňku usnadňuje provedení centralizovaných změn nebo lokalizaci prostředky do různých jazyků.

Dřívější verze aplikace Visual Studio používaly položky registru pro SatelliteDllPath a SatelliteDllName.Položky registru jsou nyní nahrazeny položkami v registračním souboru s příponou ADDIN.Pokud požadujete zdroj v projektu, můžete načíst doplněk a Visual Studio nastavit na něho dotazy pro satelitní knihovny DLL.V důsledku toho nemáte pevně kódovat cestu prostředku.Také namísto použití metody #id k určení ID zdroje, použijte @resource name (kde resource name je název prostředku, například @Icon1 nebo @String1). Symbol @ řekne aplikaci Visual Studio, aby provedla hledání prostředku v satelitní knihovně DLL.

Vytváření spravovaných satelitních knihoven DLL

Následující kroky ukazují, jak vytvořit satelitní knihovnu DLL, která obsahuje prostředky pro řetězec a ikonu, a jak změnit doplněk, aby měl přístup k těmto prostředkům.Používá doplněk s dialogovým oknem O produktu, který vyžaduje prostředky pro řetězec a ikonu.Obvykle pokud vytvoříte doplněk, který má dialogové okno O, zobrazí se výchozí ikona a text.Tyto kroky také ukazují, jak nahradit výchozí ikonu a text pomocí vlastních prostředků.

Vytvoření spravované satelitní knihovny DLL

  1. V nabídce Soubor klikněte na příkaz Nový a potom na Projekt.

  2. V dialogovém okně Nový projekt rozbalte položku Jiné typy projektů a potom vyberte možnost Projekty rozšiřitelnosti.

  3. V podokně Šablony vyberte možnost Doplněk pro sadu Visual Studio.

  4. Postupujte podle pokynů v Průvodci doplňky sady Visual Studio.Na stránce Výběr informací nápovědy vyberte možnost Ano, chtěl bych, aby tento doplněk nabízel informace "O produktu".Potvrďte zbývající výchozí výběry.

  5. V nabídce Projekt klepněte na příkaz Přidat odkaz.

  6. Na kartě .NET klepněte na tlačítko System.Drawing a potom klepněte na tlačítko OK.

  7. V Průzkumníku řešení klikněte pravým tlačítkem myši na projekt doplňku, klikněte na položku Přidat a poté Nová položka.

  8. Vyberte Soubor prostředků v seznamu šablon a klepněte na tlačítko Přidat.Přijměte výchozí název (Resources1.resx).

    Ve výchozím nastavení toto vytvoří soubor prostředků s názvem Resource1.resx a spustí Editor prostředků Visual Studio.

  9. V Resource1.resx, vyberte Ikony v seznamu Řetězce (tlačítko zcela vlevo nahoře).

  10. Na seznamu Přidat prostředek klepněte na možnost Přidat novou ikonu.Prozatím ponechejte výchozí název (Icon1.bmp) a klikněte na tlačítko Přidat.

    Alternativně můžete vybrat existující rastrový obraz ikony, pokud má rozlišení 16 x 16 pixelů a 16 barev nebo True Color.

  11. Po otevření ikony v Editoru ikon ji můžete upravit pomocí nástrojů.Až budete hotovi, zavřete Editor ikon a uložte změny.

  12. Vyberte Přidat nový řetězec v seznamu Přidat prostředek.

  13. Klepněte na první pole ve sloupci Jméno.

    Tím se vytvoří výchozí prostředek řetězce s názvem Řetězec1.

  14. Zadejte Řádek jedna do pole Hodnota.

    Toto je hodnota pro první prostředek řetězce.

  15. Vytvořte dva další prostředky řetězců a pojmenujte je „Řádku dvě“ a „Řádek tři“.

  16. Zavřete editor prostředků a uložte změny.

  17. V Průzkumníku řešení klikněte pravým tlačítkem myši na soubor Resource1.resx a potom klikněte na položku Vlastnosti.

  18. V okně Vlastnosti upravte Akce sestavení z Integrovaný prostředek na Žádný.

    To zabrání vestavění prostředku do sestavení doplňku.

  19. Sestavte projekt.

  20. Vytvořte satelitní knihovnu DLL prostředku.To se provádí jako proces ve dvou krocích pomocí ResGen a potom AL (Assembly Linker) k sestavení satelitní knihovny DLL.

    1. Klikněte na Start, Všechny programy, Microsoft Visual Studio 2010 a Nástroje sady Visual Studio a poté klikněte na Příkazová řádka sady Microsoft Visual Studio (2010).

      Toto nastavuje určité proměnné prostředí, takže můžete snadno odkazovat na nástroje Visual Studio.

    2. Přejděte na příkazovém řádku do složky, která obsahuje soubor RESX a zadejte Resgen Resource1.resx.

      Resgen je nástroj, který kompiluje zadaný soubor RESX do souboru resources.Další informace naleznete v tématu Resgen.exe (generátor zdrojových souborů).

    3. Na příkazovém řádku zadejte AL.exe /embed:Resource1.resources /culture:en-US /out:Add-In Name.resources.dll.

      Nahraďte Add-In Name za název tohoto doplňku.Například pokud projekt doplňku je pojmenován MyAddin, pak přepínač /out: by byl /out:MyAddin.resources.dll.Název /out: musí odpovídat názvu projektu, jinak DLL prostředku nebude nalezena.

      AL.exe (Assembly Linker) převede zadaný soubor .resources na knihovnu DLL, kterou můžete odkazovat v doplňku. (Lze změnit přepínač /culture na jiný jazyk než angličtinu.) Další informace naleznete v tématu Al.exe (linker sestavení).

  21. V Průzkumníku souborů přejděte do adresáře DLL doplňku a vytvořte složku s názvem \en-US\ (pro národní prostředí English US, protože jste zadali en-US pro hodnotu národního prostředí v AL.exe).

  22. Zkopírujte soubor Add-In Name.resources.dll do nové složky \en-US\.

  23. V Průzkumníku souborů přejděte do adresáře \Addins\, obvykle ..\Documents and Settings\user name\My Documents\Visual Studio 2010\Addins\.

  24. Upravte soubor s definicí doplňku Visual Studio takto:

    1. Klepněte pravým tlačítkem na soubor definice doplňku, klepněte na tlačítko Otevřít v programu a potom klepněte na tlačítko Poznámkový blok.

    2. Nahraďte následující značky:

          <FriendlyName>@String1</FriendlyName>
    <Description>@String2</Description>
    <AboutBoxDetails>@String3</AboutBoxDetails>
    <AboutIconData>@Icon1</AboutIconData>

      Položka Popisný název změní váš doplněk na Řádek1, který je zadán v Řetězci1 v souboru Resource1.resx.Popis v dialogovém okně O produktu nyní obsahuje "Řádek2" a položka AboutIconData odpovídá ikoně vytvořené pro dialogové okno O produktu.

    3. Před příponu názvu sestavení vložte .resources.

  25. Sestavte projekt znovu a vyberte doplněk ve Správci doplňků.

  26. V nabídce Nápověda klepněte na tlačítko O produktu Microsoft Visual Studio a vyberte ze seznamu možnost Řádek1 (název doplňku).

    Zobrazí se vlastní ikona a tři řetězce, které jste vytvořili.

Viz také

Úkoly

Postupy: Přístup k prostředkům v satelitních knihovnách DLL

Koncepty

Registrace doplňku