Konfigurieren von VSZ-Dateien zum Starten von Assistenten

Visual Studio verwendet zum Starten von Assistenten einen Dateityp mit dem Namen VSZ.Bei diesen Dateien handelt es sich um Textdateien mit der Dateinamenerweiterung VSZ, mit deren Hilfe Visual Studio ermittelt, welcher Assistent gestartet werden soll und welche Informationen ggf. übergeben werden sollen.

Vergleich mit der INI-Datei

Bei einer VSZ-Datei handelt es sich um eine vereinfachte Version einer Textdatei im INI-Format mit der Ausnahme, dass es keine beschrifteten Abschnitte gibt.Im ersten Abschnitt sind Informationen gespeichert, die der Visual Studio-Umgebung bekannt sind.Der zweite Abschnitt ermöglicht die Erfassung spezieller Parameter für den Assistenten und die Übergabe an den Assistenten.

Ein Beispiel für eine VSZ-Datei:

VSWizard 8.0
Wizard=VIDWizard.CBlankSiteWizard
Param=<item1>
Param=<item2>
…
HinweisHinweis

Der Wert des Assistenten kann auch eine GUID im Format {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} sein, bestehend aus Abschnitten der Länge 8,4,4,4 und 12 Zeichen.

Die Datei weist diese Abschnitte auf:

  • VSWizard – Hierbei handelt es sich um die Versionsnummer des Vorlagendateiformats, das für Visual Studio "VSWizard 8.0" lautet. Andere Versionsnummern sind nicht zulässig, da andernfalls der Fehler "Ungültiges Format" ausgegeben wird.

  • Wizard – Hierbei handelt es sich um den programmatischen Bezeichner (ProgID), z. B. MyWizard.MyClass, oder eine andere Zeichenfolgenentsprechung der CLSID des Assistenten, die zusammen mit Visual Studio erstellt werden sollte.

  • Param – Diese Parameter sind optional. Sie können so viele Parameter hinzufügen, wie der Assistent erfordert.Sie werden ebenfalls verwendet, damit die VSZ-Datei weitere benutzerdefinierte Parameter an den Assistenten übergeben kann.Jeder Wert wird als Zeichenfolgenelement in einem Array an den Assistenten übergeben.

Siehe auch

Aufgaben

Gewusst wie: Erstellen von Add-Ins

Exemplarische Vorgehensweise: Erstellen eines Assistenten

Konzepte

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

Weitere Ressourcen

Erstellen von Add-Ins und Assistenten