Udostępnij za pośrednictwem

Dodawanie kreatorów, aby dodać element i okno dialogowe Nowy projekt przy użyciu.Pliki Vsdir

  • Artykuł

Plik VSDir jest plik tekstowy z rozszerzeniem .vsdir, że Utwórz informacje o wyświetlaniu jej elementy do Dodaj element i Nowy projekt okien dialogowych.Informacje zawierają nazwy elementów, kolejność i ikona wyświetlana z nimi.Można zmienić dowolny z tych elementów.Pliki VSDir są używane do dodawania nowych szablonów i kreatorów, aby Dodaj element i Nowy projekt okien dialogowych.

Nie ma domyślnego pliku VSDir.Jeżeli jest dostępny, następnie Visual Studio go odczytuje i dodaje jego zawartość w oknach dialogowych.Jeżeli nie jest dostępny, następnie domyślne szablony i kreatorzy wyświetlania.Może mieć wiele plików VSDir w jednym katalogu i wszystkich ich zawartość zostanie dodana do okna dialogowego.Zazwyczaj jeden plik VSDir zawiera rekordy wielu kreatorów, folderów i szablonów.Każdy rekord w pliku jest oddzielone znakiem nowego wiersza.Znaki potoku (|) poszczególne pola w każdym rekordzie.Wszelkie opcjonalne pole, dla którego nie ma istotnych danych zawiera zero (0) lub spacji jako symbol zastępczy.Ciągi, wprowadzone w polach nie wymagają je w cudzysłowie.

Składniki pliku VSDir

Poniżej podano przykłady plików VSDir.Pierwsza odwołuje się do jednego kreatora, utworzony w temacie Instruktaż: Tworzenie kreatora:

MyNewWizard.vsz| |A New Wizard|1|My New Wizard|C:\Addins\MyNewWizard\MyNewWizard\bin\Debug| | |MyNewWizard99

Następny przykładowy plik VSDir odwołuje się do liczby plików .vsz kreatora, wraz z innymi informacji odnoszącej się do każdego kreatora (opisane dalej w tym temacie).Różnią się one od poprzedniego pliku VSDir w tym odwołują ciągi jako numery identyfikatorów zasobów, nie ciągi.Ponadto używają identyfikatorów GUID do odniesienia biblioteki 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

Dla każdego rekordu w pliku VSDir można określić następujące pola:

Pole

Znaczenie

RelPathName

Wymagane.Nazwa .vsz Kreatora plików, takich jak MyWizard.vsz, odnoszących się do Visual Studio zainstalować katalog.

{clsidPackage}

Opcjonalne.Identyfikator GUID, reprezentujący produktu (takie jak Visual C++) ma biblioteki DLL zawierającej zlokalizowanych zasobów.Zwykle to pole jest puste dla plików VSDir, które odpowiadają kreatorzy strony trzeciej.

LocalizedName

Opcjonalne.To jest lokalizowalnym nazwę kreatora lub szablonu oraz nazwę, która pojawia się w Dodaj element okno dialogowe.Może to być ciąg lub identyfikator zasobu formularza #ResID.

SortPriority

Wymagane.Liczba całkowita reprezentująca porządek sortowania i względny priorytet kreatora, gdzie 1 oznacza najwyższą.Na przykład jeśli ten element jest "1", następnie to będą wyświetlane obok innych 1s i z wyprzedzeniem wszystkie 2s lub niższy.

Opis

Wymagane.Lokalizowalnym opisem szablon lub Kreator w postaci, w jakiej będą wyświetlane w Dodaj element okno dialogowe, gdy element jest zaznaczony.Może to być ciąg lub identyfikator zasobu formularza #ResID.Dotyczy tylko plików szablonów, nie folderów.

Ścieżka dll lub {clsidPackage}

Wymagane.Określa pełną ścieżkę do pliku DLL lub EXE lub identyfikator GUID produktu, który zawiera plik .dll, który zawiera ikonę, aby załadować do kreatora.Ikona jest ładowany jako zasoby pliku DLL/EXE przy użyciu danego IconResourceId.Ustawienie to zastępuje {clsidPackage}, jeśli określony dla lokalizacji ikon.Dotyczy tylko plików szablonów, nie folderów.

IconResourceId

Opcjonalne.W pliku DLL, który określa tę ikonę, aby wyświetlić identyfikator zasobu.Jeśli ikona nie jest zdefiniowana, środowiska substytuty ikona domyślna dla pliku z rozszerzeniem samego jako element.Dotyczy tylko plików szablonów, nie folderów.

Flagi

Opcjonalne.Zobacz Flags opis i w poniższej tabeli.Dotyczy tylko plików szablonów, nie folderów.

SuggestedBaseName

Wymagane.Domyślna nazwa dla kreatora, wyświetlane w Nazwa pola w oknie dialogowym.Jest to ciąg lub identyfikator zasobu formularza #ResID.Jeśli nazwa nie jest unikatowa, środowiska dołącza nazwę z liczbą całkowitą.Na przykład MyFile.aspx może być zmieniana na MyFile1.aspx.Jeśli nazwa nie zostanie podana, "Projekt" jest używany.Dotyczy tylko plików szablonów, nie folderów.

  • Notatki
    Wszelkie-wymagane pola, dla którego nie ma istotnych danych powinien zawierać 0 (zero) jako symbol zastępczy.

    Jeśli żadna nazwa zlokalizowana jest warunkiem używana jest ścieżka względna.

    Jeśli ikona nie jest zdefiniowana, IDE substytuty ikona domyślna dla pliku z tym rozszerzeniem.

    Warunkiem nie sugerowana nazwa podstawowa "Projekt" jest używany.

  • Flagi
    Grupy flag bitowych używanych do włączania lub wyłączania Nazwa i lokalizację pól na Dodaj element okno dialogowe.To znaczy, gdy użytkownik wybierze Dodaj nowy element z Dodaj menu projektu określa, czy nazwa i lokalizacja są wyświetlane w szablonów okienka, ale flagi należy sprawdzić, czy nazwa i lokalizacja są dostępne dla użytkownika.

    Należy ustawić wartość Flags do sumy poszczególnych wartości.Oznacza to, że jest równoważne z VSDIRFLAG_NonLocalTemplate 33 | VSDIRITEM_DisableLocationField.

    Nazwa flagi

    Wartość dziesiętna

    Opis

    VSDIRFLAG_NonLocalTemplate

    1

    Użyj zachowania interfejsu użytkowników nielokalnych i Zapisz mechanizmów.

    VSDIRFLAG_BlankSolution

    2

    Utwórz pusty roztwór (puste).Nie należy tworzyć projektu.

    VSDIRFLAG_DisableBrowseButton

    4

    Wyłącz przycisk Przeglądaj dla tego projektu lub elementu.

    VSDIRFLAG_DontAddDefExtension

    8

    Nie można dołączyć domyślne rozszerzenie na nazwę podaną dla towaru.(To ustawienie nie jest prawidłowe dla projektów).

    VSDIRFLAG_DisableLocationField

    32

    Wyłącz pole lokalizacji dla tego projektu lub elementu.

    VSDIRFLAG_DontInitNameField

    4096

    Nie udało się zainicjalizować pola nazwy dla tego projektu lub element z prawidłową nazwą.

    VSDIRFLAG_DisableNameField

    8192

    Wyłącz pola nazwy dla tego projektu lub elementu.

Zobacz też

Zadania

Jak: Tworzenie dodatku

Instruktaż: Tworzenie kreatora

Koncepcje

Projektowanie Kreatora

Konfigurowanie.Pliki Vsz, aby uruchomić kreatorów

Inne zasoby

Tworzenie dodatków i kreatorów