自定义参数

自定义参数控制向导启动后向导的操作。 相关的 .vsz 文件提供用户定义的参数数组,这些参数由集成开发环境(IDE)打包,并在向导启动时作为字符串数组传递给向导。 然后,该向导分析字符串数组,并使用信息来控制向导的实际操作。 通过这种方式,向导可以根据 .vsz 文件的内容自定义功能。

另一方面,上下文参数定义启动向导时项目的状态。 有关详细信息,请参阅 上下文参数

下面是具有自定义参数的 .vsz 文件的示例:

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"

.vsz 文件的作者添加参数的值。 当用户在“文件”菜单上选择“新建项目”或“添加新项”或右键单击解决方案资源管理器中的项目时,IDE 会将这些值收集到字符串数组中。 然后,IDE 使用VSADDITEMOPERATION标志集调用项目AddItem的方法,项目调用RunWizardFile负责运行向导并返回结果的方法。

向导负责分析字符串数组并适当地处理字符串。 通过这种方式,通过实现自定义参数,可以创建一个执行各种函数的向导。 换句话说,一个向导可以有三个不同的 .vsz 文件。 每个文件都会传递不同的自定义参数集,以在各种情况下控制向导的行为。

有关详细信息,请参阅 Wizard (.vsz) 文件