Freigeben über


Benutzerdefinierte Parameter

Benutzerdefinierte Parameter steuern die Ausführung eines Assistenten, nachdem ein Assistent gestartet wurde. Eine verwandte VSZ-Datei enthält ein Array von benutzerdefinierten Parametern, die von der integrierten Entwicklungsumgebung (IDE) an den Assistenten übergeben und als Zeichenfolgenarray gepackt werden, wenn der Assistent gestartet wird. Der Assistent dann analysiert das Zeichenfolgenarray und verwendet die Informationen, um den tatsächlichen Vorgang des Assistenten zu steuern. Auf diese Weise kann ein Assistent Funktionen abhängig vom Inhalt der VSZ-Datei anpassen.

Kontextparameter definieren hingegen den Stand des Projekts, wenn der Assistent gestartet wird. Weitere Informationen finden Sie unter Kontextparameter.

Im Folgenden finden Sie ein Beispiel für eine VSZ-Datei mit benutzerdefinierten Parameter verfügt:

VSWIZARD 8.0
Wizard=VsWizard.VsWizard_Engine
Param="WIZARD_NAME = Sample Wizard"
Param="WIZARD_UI = FALSE"
Param="RELATIVE_PATH = VSWizards\Classwiz\ATL"
Param="PREPROCESS_FUNCTION = CanAddATLSupport"
Param="PROJECT_TYPE = CSPROJ"

Der Autor der VSZ-Datei fügt die Werte der Parameter hinzu. Wenn ein Benutzer Neues Projekt oder Neues Element hinzufügen im Menü Datei auswählen oder indem er auf ein Projekt in Projektmappen-Explorermit der rechten Maustaste klickt, werden die IDE diese Werte in ein Zeichenfolgenarray. Die IDE ruft dann die AddItem-Methode des Projekts mit dem VSADDITEMOP_RUNWIZARD-Flags festgelegt, und das Projekt RunWizardFile ruft die Methode auf, die zum Ausführen des Assistenten und die Rückgabe des Ergebnisses zuständig ist.

Der Assistent ist für das Array von Zeichenfolgen geeignet analysieren und nach Zeichenfolgen werden. Auf diese Weise indem Sie benutzerdefinierte Parameter implementieren, können Sie einen Assistenten erstellen, der eine Vielzahl von Funktionen ausführt. Das heißt, kann ein Assistent drei verschiedene .vsz-Dateien haben. Jede Datei führt verschiedene Sätze von benutzerdefinierten Parameter, um das Verhalten des Assistenten in verschiedenen Situationen zu steuern.

Weitere Informationen finden Sie unter (Assistent. Datei Vsz).

Siehe auch

Referenz

IVsProject3

Konzepte

Kontextparameter

(Assistent. Datei Vsz)

Weitere Ressourcen

Assistenten