Parametry kontekstu uruchomiania kreatorów

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

Parametry kontekstu dostarczają informacji wymaganych do uruchomienia kreatora, takich jak typ kreatora do wykorzystania, nazwę projektu, katalogi dla elementów kreatora i tak dalej.

Istnieją trzy różne typy kreatorów:

  • NewProject — dodaje nowy projekt do rozwiązania.

  • AddSubProject — dodaje podprojekt do istniejącego projektu.

  • AddItem — dodaje element do istniejącego projektu.

Wszystkie trzy typy kreatorów są wywoływane za pomocą metody Execute interfejsu IDTWizard.Wymagany parametr jednego z Execute metody jest ContextParams.Każdy typ wymaga innego zestawu wartości ContextParams w odpowiedniej kolejności, jak podano w poniższej tabeli:

Typ kreatora

Użyte parametry

NewProject

  • Typ kreatora

  • ProjectName

  • LocalDirectory

  • InstallationDirectory

  • F Wyłącznych

  • Nazwa rozwiązania

  • Silent

AddSubProject

  • Typ kreatora

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • Typ kreatora

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

Poniższa tabela zawiera listę wszystkich parametrów kontekstu i ich opisy.

Ustawienie

Opis

WizardType

Stała określająca rodzaj kreatora.Istnieją trzy typy:

  • vsWizardNewProject (identyfikator GUID = "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddItem (identyfikator GUID = "{0F90E1D1-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddSubProject (identyfikator GUID = "{0F90E1D2-4999-11D1-B6D1-00A0C90F2744}")

ProjectName

Nazwa projektu.

ProjectItems

Wskaźnik do kolekcji ProjectItems, w której kreator będzie działać.To jest przekazywane do kreatora na podstawie pozycji wybranej hierarchii projektu.

LocalDirectory

Lokalizacja w systemie lokalnym, gdzie są przechowywane pliki projektu pracy kreatora.

ItemName

Nazwa elementu do dodania.ItemName jest nazwą pliku wpisywaną przez użytkownika (lub, która jest zaakceptowana domyślne) w oknie dialogowym Dodaj element.W zależności od flag ustawionych w pliku VSDIR, to ustawienie może być NULL.

InstallationDirectory

Ścieżka do katalogu gdzie Visual Studio jest zainstalowany.

FExclusive

Wartość typu boolean wskazująca, czy projekt ma być wyłączny sam w sobie.Oznacza to, że projekt jest dodawany do bieżącego rozwiązania albo system powoduje zamknięcie bieżącego rozwiązania, tworzy nowy, a następnie dodaje do niego projekt.

SolutionName

Nazwa pliku rozwiązania bez katalogu części lub rozszerzenia .sln. (Nazwa pliku .suo opiera się również na głównej części nazwy pliku). Jeśli SolutionName zawiera wartość (tzn., jeśli nie jest ciągiem pustym), kreator NewProject wywołuje Create przed dodaniem projektu z AddFromTemplate.Jednak, jeśli SolutionName jest ciągiem pustym, nie trzeba wywołać Createprzed wywołaniem funkcji AddFromTemplate.

Silent

Wartość typu boolean wskazująca, czy kreator powinien pracować w trybie cichym, bez wyświetlania interfejsu użytkownika (UI), uwzględniając wszystkie wartości domyślne.Wartość domyślna dla Silent to True.

Zobacz też

Informacje

Execute

IDTWizard

Koncepcje

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