Benutzerdefinierte Parameter
Benutzerdefinierte Parameter steuern den Vorgang eines Assistenten, nachdem ein Assistent gestartet wurde. Eine zugehörige VSZ-Datei stellt ein Array von benutzerdefinierten Parametern bereit, die von der integrierten Entwicklungsumgebung (IDE) gepackt und beim Starten des Assistenten als Array von Zeichenfolgen an den Assistenten übergeben werden. Der Assistent analysiert dann das Array von Zeichenfolgen und verwendet die Informationen, um den tatsächlichen Vorgang des Assistenten zu steuern. Auf diese Weise kann ein Assistent die Funktionalität je nach Inhalt der VSZ-Datei anpassen.
Kontextparameter definieren dagegen den Status des Projekts, wenn der Assistent gestartet wird. Weitere Informationen finden Sie unter Kontextparameter.
Nachfolgend sehen Sie ein Beispiel für eine VSZ-Datei mit benutzerdefinierten Parametern:
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" auswählt oder "Neues Element hinzufügen" im Menü "Datei" auswählt oder mit der rechten Maustaste auf ein Projekt in Projektmappen-Explorer klickt, sammelt die IDE diese Werte in einem Array von Zeichenfolgen. Die IDE ruft dann die Methode des AddItem Projekts mit dem VSADDITEMOPERATION Flagsatz auf, und das Projekt ruft die RunWizardFile Methode auf, die für die Ausführung des Assistenten verantwortlich ist und das Ergebnis zurückgibt.
Der Assistent ist dafür verantwortlich, das Array von Zeichenfolgen zu analysieren und entsprechend auf die Zeichenfolgen zu handeln. Auf diese Weise können Sie durch Implementieren von benutzerdefinierten Parametern einen Assistenten erstellen, der eine Vielzahl von Funktionen ausführt. Mit anderen Worten, ein Assistent könnte drei verschiedene VSZ-Dateien haben. Jede Datei übergibt unterschiedliche Gruppen von benutzerdefinierten Parametern, um das Verhalten des Assistenten in verschiedenen Situationen zu steuern.
Weitere Informationen finden Sie in der Assistentendatei (VSZ).