自訂參數
如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。
啟動精靈之後自訂參數來控制精靈的作業。 相關的.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 然後呼叫專案的AddItem方法VSADDITEMOP_RUNWIZARD旗標集以及專案呼叫RunWizardFile負責執行精靈,並傳回結果的方法。
精靈會負責剖析的字串陣列,並適當地對字串。 在這種方式,藉由實作自訂參數您可以建立一個精靈,執行不同的功能。 換句話說,只需要一個精靈可能會有三個不同的.vsz 檔案。 每個檔案會傳遞不同的自訂參數來控制精靈,在各種情況下的行為。
如需詳細資訊,請參閱精靈 (。Vsz) 檔案。