Udostępnij za pośrednictwem

Dodawanie kreatorów do okien dialogowych Dodawanie elementu i Nowy projekt za pomocą plików .Vsdir

  • Artykuł

Dodatki Visual Studio zostały zaniechane w programie Visual Studio 2013.Dodatki należy uaktualniać do pakietu rozszerzenia VSPackage.Aby uzyskać więcej informacji na temat uaktualniania, zobacz Często zadawane pytania: konwertowanie dodatków na rozszerzenia pakietu VSPackage.

Plik VSDir jest plikiem tekstowym z rozszerzeniem .vsdir, który został utworzony w celu udzielenia informacji o sposobie wyświetlaniu jego elementów w oknach dialogowych Dodaj element i Nowy projekt.Informacje obejmują nazwy elementów, kolejność, w jakiej są wyświetlane i ikona wyświetlana z nimi.Można zmienić te elementy.Pliki VSDir są używane do dodawania nowych szablonów i kreatorów do okien dialogowych Dodaj element i Nowy projekt .

Nie ma domyślnego pliku VSDir.Jeżeli jest dostępny, wówczas Visual Studio go odczytuje i dodaje jego zawartość do okien dialogowych.Jeżeli nie jest dostępny, wówczas zostaną wyświetlone domyślne szablony i kreatorzy.Może mieć wiele plików VSDir w pojedynczym katalogu i ich cała zawartość zostanie dodana do okna dialogowego.Zazwyczaj jeden plik VSDir zawiera rekordy wielu kreatorów, folderów i szablony.Każdy rekord w pliku jest oddzielony znakiem nowego wiersza.Znaki rury (|) rozdzielają pola w każdym rekordzie.Wszystkie opcjonalne pole, dla których nie ma żadnych istotnych danych zawierają wartość 0 (zero) lub znak spacji jako symbol zastępczy.Ciągi wprowadzone w polach nie wymagają cudzysłowu.

Składniki pliku VSDir

Poniżej podano przykłady plików VSDir.Pierwszy z nich odwołuje się do jednego kreatora, utworzonego w temacie Wskazówki: 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, a także innych istotnych informacji odnoszących się do każdego kreatora (opisane dalej w tym temacie).Są one różne od poprzedniego pliku VSDir, w ten sposób, że odwołują się do ciągów, jako numery ID zasobu a nie ciągi tekstowe.Ponadto, używają identyfikatorów GUID do odniesienia bibliotek 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

Pola mogą być określone dla każdego rekordu w pliku VSDir:

Pole

Znaczenie

RelPathName

Wymagany.Nazwa kreatora plików .vsz , takich jak MyWizard.vsz, stosunku do Visual Studio katalogu instalacji.

{clsidPackage}

Opcjonalnie.Identyfikator GUID, reprezentujący produkt (taki jak Visual C++), który posiada bibliotekę DLL zawierającą zlokalizowane zasoby.Zazwyczaj pole to jest puste dla plików VSDir, które odnoszą się do kreatorów innych firm.

LocalizedName

Opcjonalnie.To jest możliwa do zlokalizowania nazwę kreatora lub szablonu i nazwa ta pojawia się w oknie dialogowym Dodaj element.Może to być ciąg lub identyfikator zasobu formularza #ResID.

SortPriority

Wymagany.Liczba całkowita reprezentująca kolejność sortowania i relatywny priorytet kreatora, gdzie 1 oznacza najwyższy.Na przykład, jeśli ten element ma wartość „1”, wówczas pojawi się obok innych 1-ek i przed wszystkimi 2-kami lub niższymi.

Opis

Wymagany.Lokalizowalny opis szablonu lub kreatora w postaci, w jakiej pojawi się w oknie dialogowym Dodaj element, gdy element zostanie zaznaczony.Może to być ciąg lub identyfikator zasobu formularza #ResID.Dotyczy tylko plików szablonów, nie folderów.

DLLPath lub {clsidPackage}

Wymagany.Określa pełną ścieżkę do pliku DLL lub EXE lub identyfikator GUID produktu, który ma pliku .dll, który zawiera ikonę, aby załadować dla kreatora.Ikona jest ładowana jako zasób z pliku DLL/EXE za pomocą danej IconResourceId.Ustawienie to zastępuje {clsidPackage}, jeśli jest określone dla lokalizacji ikony.Dotyczy tylko plików szablonów, nie folderów.

IconResourceId

Opcjonalnie.Identyfikator zasobu w pliku DLL, który określa ikonę do wyświetlenia.Jeśli nie zdefiniowano żadnej ikony, środowisko zastępuje domyślną ikonę pliku z tym samym rozszerzeniem jako elementem.Dotyczy tylko plików szablonów, nie folderów.

Flagi

Opcjonalnie.Zobacz Flags opis i poniższą tabelę.Dotyczy tylko plików szablonów, nie folderów.

Sugerowana nazwa podstawowa

Wymagany.Domyślna nazwa dla kreatora, wyświetlana w polu Nazwa w oknie dialogowym.Może to być 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ć zmieniony na MyFile1.aspx.Jeśli nie podano żadnej nazwy, wówczas nazwa „Projekt” jest używana.Dotyczy tylko plików szablonów, nie folderów.

  • Uwagi
    Wszystkie pole niewymagane, dla których nie ma żadnych istotnych danych powinny zawierać wartość 0 (zero) jako symbol zastępczy.

    Jeśli nie podano żadnej zlokalizowanej nazwy, używana jest ścieżka relatywna.

    Jeśli nie zdefiniowano żadnej ikony, IDE zastępuje domyślną ikonę pliku z tym rozszerzeniem.

    Jeśli nie podano żadnej sugerowanej nazwy, nazwa „Projekt” jest używana.

  • Flagi
    Grupa znaczników bitowych używana do włączania lub wyłączania pól Nazwa i Lokalizacja w oknie dialogowym Dodaj element.To znaczy, gdy użytkownik wybierze Dodaj nowy element z menu Dodaj , projektu określa, czy nazwa i lokalizacja są wyświetlane w okienku Szablony , ale znaczniki określają, czy nazwa i lokalizacja są dostępne dla użytkownika.

    Ustaw wartość Flags do sumy poszczególnych wartości.33 Jest równoważne z VSDIRFLAG_NonLocalTemplate | VSDIRITEM_DisableLocationField.

    Nazwa flagi

    Wartość dziesiętna

    Opis

    VSDIRFLAG_NonLocalTemplate

    1

    Użyj nie-lokalnego zachowania interfejsu użytkownika i zapisz mechanizmy.

    VSDIRFLAG_BlankSolution

    2

    Utwórz puste rozwiązanie.Nie twórz projektu.

    VSDIRFLAG_DisableBrowseButton

    4

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

    VSDIRFLAG_DontAddDefExtension

    8

    Nie dołączaj rozszerzenia domyślnego do podanej nazwy elementu. (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 inicjuj pola nazwy dla tego projektu lub elementu z prawidłową nazwą.

    VSDIRFLAG_DisableNameField

    8192

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

Zobacz też

Zadania

Porady: tworzenie dodatku

Wskazówki: tworzenie kreatora

Koncepcje

Projektowanie kreatora

Konfigurowanie plików .Vsz do uruchamiania kreatorów

Inne zasoby

Tworzenie dodatków i kreatorów