Přidávání průvodců do dialogových oken Přidat položku a Nový projekt pomocí souborů .Vsdir
Doplňky Visual Studio jsou ve verzi aplikace Visual Studio 2013 zastaralé.Měli byste upgradovat doplňky na rozšíření VSPackage.Další informace o upgradu viz Nejčastější dotazy: Převádění doplňků na rozšíření VSPackage.
Soubor VSDir je textový soubor s příponou .vsdir, který vytvoříte za účelem poskytnutí informací o způsobu zobrazení položek v dialogových oknech Přidat položku a Nový projekt.Tyto informace zahrnují názvy položek, pořadí, ve kterém jsou zobrazeny, a ikonu, která je u nich zobrazena.Můžete změnit libovolnou z těchto položek.Soubory VSDir se používají k přidání nových šablon nebo průvodců do dialogových oken Přidat položku a Nový projekt .
Neexistuje výchozí soubor VSDir.Pokud je jeden k dispozici, pak ho Visual Studio přečte a přidá jeho obsah do dialogových oken.Pokud jeden není uveden, zobrazí se výchozí šablony a průvodci.Můžete mít více souborů VSDir v jednom adresáři a veškerý jejich obsah bude přidán do dialogových oknech.Jeden soubor VSDir obvykle obsahuje záznamy pro více průvodců, složek a šablon.Každý záznam v souboru jsou oddělen znakem nového řádku.Znaky svislé čáry (|) oddělují pole v jednotlivých záznamech.Libovolné volitelné pole, pro které neexistují žádná smysluplná data, obsahuje nulu 0 nebo mezeru jako zástupný znak.Řetězce, které jsou zadány do polí, nevyžadují kolem sebe uvozovky.
Součásti souboru VSDir
Následují příklady souborů VSDir.První odkazuje na jediného průvodce, který byl vytvořen v tématu Návod: Vytvoření průvodce:
MyNewWizard.vsz| |A New Wizard|1|My New Wizard|C:\Addins\MyNewWizard\MyNewWizard\bin\Debug| | |MyNewWizard99
Další ukázkový soubor VSDir odkazuje na počet souborů průvodce .vsz a ostatní relevantní informace týkající se jednotlivých průvodců (jak je uvedeno dále v tomto tématu).Ty se liší od předchozího souboru VSDir v tom, že odkazují na řetězce čísly ID prostředku, nikoli řetězcovými literály.Také používají identifikátory GUID k odkazování knihoven DLL.
..\..\Projects\csharp building blocks\BusinessFacade.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5015|10|#5022|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|127|0|Project
..\..\Projects\csharp building blocks\BusinessRules.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5016|20|#5023|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|128|0|Project
..\..\Projects\csharp building blocks\DataAccess.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5017|30|#5024|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|129|0|Project
..\..\Projects\csharp building blocks\SystemFrameworks.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5018|40|#5025|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|130|0|Project
..\..\Projects\csharp building blocks\WebService.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5019|50|#5026|{FAE04EC1-301F-11d3-BF4B-00C04F79EFBC}|4547|1|WebService|Web
..\..\Projects\csharp building blocks\WebUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5020|60|#5027|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|131|1|WebUI|web
..\..\Projects\csharp building blocks\WinUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5021|70|#5028|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|132|0|Project
Pro každý záznam v souboru VSDir lze zadat následující pole:
Pole |
Význam |
|---|---|
RelPathName |
Požadováno.Název souboru průvodce .vsz, například MyWizard.vsz, relativní k instalačnímu adresáři aplikace Visual Studio. |
{clsidPackage} |
Volitelné.Identifikátor GUID představující produkt (jako Visual C++), který má knihovnu DLL obsahující lokalizované prostředky.Standardně je toto pole prázdné pro soubory VSDir, které odpovídají průvodcům třetích stran. |
LocalizedName |
Volitelné.Toto je lokalizovatelný název průvodce nebo šablony a název se zobrazí v dialogovém okně Přidat položku.To může být řetězec nebo identifikátor prostředku ve formě #ResID. |
SortPriority |
Požadováno.Celé číslo představující pořadí řazení a relativní prioritu průvodce, kdy 1 je nejvyšší.Například pokud je tato položka "1", pak se tento údaj zobrazí vedle jiných údajů 1 a před všemi údaji 2 nebo nižší. |
Description |
Požadováno.Lokalizovatelný popis šablony nebo průvodce, které se zobrazí v dialogovém okně Přidat položku po výběru položky.To může být řetězec nebo identifikátor prostředku ve formě #ResID.Platí pouze pro soubory šablon, ne složky. |
DLLPath nebo {clsidPackage} |
Požadováno.Určuje úplnou cestu k souboru DLL nebo EXE nebo identifikátor GUID produktu, který má soubor .dll, který obsahuje ikonu pro načtení průvodce.Ikona je načtena jako prostředek ze souboru DLL nebo EXE pomocí dané IconResourceId.Toto nastavení přepíše {clsidPackage}, je-li určena, pro umístění ikony.Platí pouze pro soubory šablon, ne složky. |
IconResourceId |
Volitelné.Identifikátor prostředku v souboru DLL, který určuje ikonu k zobrazení.Pokud není definována žádná ikona, prostředí nahradí výchozí ikonu pro soubor stejnou příponou, jako má položka.Platí pouze pro soubory šablon, ne složky. |
Příznaky |
Volitelné.Viz popis Flags a níže uvedená tabulka.Platí pouze pro soubory šablon, ne složky. |
SuggestedBaseName |
Požadováno.Výchozí název průvodce zobrazený v poli Název v dialogovém okně.Je to buď řetězec, nebo identifikátor prostředku ve formě #ResID.Pokud název není jedinečný, prostředí připojí k názvu celé číslo.MyFile.aspx může být například změněn na MyFile1.aspx.Pokud není název zadán, používá se "Projekt".Platí pouze pro soubory šablon, ne složky. |
Poznámky
Libovolné nepovinné pole, pro které neexistují žádná smysluplná data, by mělo obsahovat hodnotu 0 (nula) jako zástupný znak.Pokud není lokalizovaný název zadán, použije se relativní cesta.
Pokud není definována žádná ikona, IDE nahradí výchozí ikonu pro soubor touto příponou.
Pokud není navržen žádný název základu, používá se "Projekt".
Příznaky
Skupina bitových příznaků používaná k povolení nebo zakázání polí Název a Místo v dialogovém okně Přidat položku.To znamená, když uživatel vybere možnost Přidat novou položku z nabídky Přidat, projektu určuje, zda se zobrazí název a umístění v podokně Šablony, ale příznaky rozhodují, zda jsou název a umístění k dispozici uživateli.Nastavte hodnotu Flags na součet jednotlivých hodnot.To znamená, že 33 je ekvivalentní VSDIRFLAG_NonLocalTemplate | VSDIRITEM_DisableLocationField.
Název příznaku
Desetinná hodnota
Description
VSDIRFLAG_NonLocalTemplate
1
Použijte chování nelokálního uživatelského rozhraní a uložte mechanismy.
VSDIRFLAG_BlankSolution
2
Vytvořte prázdné řešení.Nevytvářejte projekt.
VSDIRFLAG_DisableBrowseButton
4
Zakážete tlačítko Procházet pro tento projekt nebo položku.
VSDIRFLAG_DontAddDefExtension
8
Nepřipojujte výchozí příponu k zadanému názvu položky. (Toto nastavení není platné pro projekty.)
VSDIRFLAG_DisableLocationField
32
Zakážete pole umístění pro tento projekt nebo položku.
VSDIRFLAG_DontInitNameField
4096
Neinicializujte pole název pro tento projekt nebo položku s platný název.
VSDIRFLAG_DisableNameField
8192
Zakážete pole názvu pro tento projekt nebo položku.
Viz také
Úkoly
Koncepty
Konfigurace souborů .Vsz ke spouštění průvodců