Freigeben über

Kontextparameter zum Starten von Assistenten

  • Artikel

Add-Ins für Visual Studio sind in Visual Studio 2013 veraltet. Sie müssen für Ihre Add-Ins ein Upgrade auf VSPackage-Erweiterungen durchführen. Weitere Informationen über das Durchführen eines Upgrades finden Sie unter FAQ: Konvertieren von Add-Ins in VSPackage-Erweiterungen.

Kontextparameter stellen die zum Starten eines Assistenten erforderlichen Informationen bereit, beispielsweise der zu verwendende Assistententyp, der Name des Projekts, die Verzeichnisse für die Elemente des Assistenten usw.

Es gibt drei verschiedene Typen 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 andere ContextParams-Werte in der richtigen Reihenfolge, wie in der nachfolgenden Tabelle dargestellt:

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 werden alle Kontextparameter mit ihren Beschreibungen 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 zum Angeben, 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 SLN-Erweiterung. (Der SUO-Dateiname basiert ebenfalls auf diesem Stammnamen.) Wenn SolutionName einen Wert enthält (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