Freigeben über

Kontextparameter zum Starten von Assistenten

  • Artikel

Kontextparameter stellen die zum Starten eines Assistenten erforderlichen Informationen bereit, z. B. den verwendeten Assistenten, den Namen des Projekts, die Verzeichnisse für die Elemente des Assistenten usw.

Es gibt drei verschiedene Arten von Assistenten:

  • NewProject – Fügt einer Projektmappe ein neues Projekt hinzu.

  • AddSubProject – Fügt einem vorhandenen Projekt ein Unterprojekt hinzu.

  • AddItem – Fügt einem vorhandenen Projekt ein Element hinzu.

Alle drei Assistententypen werden mithilfe der Execute-Methode der IDTWizard-Schnittstelle aufgerufen. Einer der erforderlichen Parameter der Execute-Methode ist ContextParams. Jeder Typ erfordert – wie in der nachfolgenden Tabelle gezeigt – andere ContextParams-Werte in der richtigen Reihenfolge:

Assistententyp

Verwendete Parameter

NewProject

  • WizardType

  • ProjectName

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • SolutionName

  • Silent

AddSubProject

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

In der folgenden Tabelle sind die Kontextparameter mit ihrer Beschreibung aufgelistet.

Einstellung

Beschreibung

WizardType

Eine Konstante, die den Typ des Assistenten angibt. Es gibt drei Typen:

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

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

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

ProjectName

Der Name des Projekts.

ProjectItems

Ein Zeiger auf die ProjectItems-Auflistung, mit der der Assistent arbeitet. Dieser wird dem Assistenten entsprechend der ausgewählten Projekthierarchie übergeben.

LocalDirectory

Der Speicherort auf dem lokalen Computer, an dem die Arbeitsprojektdateien des Assistenten gespeichert sind.

ItemName

Der Name des hinzuzufügenden Elements. Bei ItemName handelt es sich um den Dateinamen, der vom Benutzer im Dialogfeld Element hinzufügen eingegeben oder aus der Voreinstellung übernommen wird. Je nach den in der VSDIR-Datei festgelegten Flags kann diese Einstellung NULL sein.

InstallationDirectory

Der Pfad des Verzeichnisses, in dem Visual Studio installiert wurde.

FExclusive

Ein boolescher Wert, der angibt, ob das Projekt exklusiv sein soll. Das Projekt wird also entweder der aktuellen Projektmappe hinzugefügt, oder das System schließt die aktuelle Projektmappe, erstellt eine neue und fügt dieser anschließend das Projekt hinzu.

SolutionName

Der Name der Projektmappendatei ohne Verzeichnisanteil und Erweiterung .sln. (Der Name der SUO-Datei basiert ebenfalls auf diesem Stammnamen.) Wenn SolutionName einen Wert enthält (d. h., keine leere Zeichenfolge ist), ruft der NewProject-Assistent Create auf, bevor das Projekt mit AddFromTemplate hinzugefügt wird. Wenn SolutionName jedoch eine leere Zeichenfolge ist, muss Createnicht vor dem Aufruf von AddFromTemplate aufgerufen werden.

Silent

Ein boolescher Wert, der anzeigt, ob der Assistent ohne Anzeige einer Benutzeroberfläche unbeaufsichtigt ausgeführt werden soll und alle Standardwerte übernommen werden sollen. Der Standardwert für Silent lautet True.

Siehe auch

Referenz

Execute

IDTWizard

Konzepte

Hinzufügen von Assistenten zu den Dialogfeldern Element hinzufügen und Neues Projekt mithilfe von VSDIR-Dateien