Konfigurieren von VSZ-Dateien zum Starten von Assistenten
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.
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>
…
Hinweis
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