自訂參數
自訂參數可在精靈啟動之後控制精靈的作業。 相關 .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 檔案。 每個檔案都會傳遞不同的自訂參數集,以在各種情況下控制精靈的行為。
如需詳細資訊,請參閱精靈 (.vsz) 檔案。