可啟動精靈的內容參數

  • 發行項

.Visual Studio 增益集在 Visual Studio 2013 中已不適用。 您應該升級您的增益集至 VSPackage 擴充套件。 如需升級的詳細資訊，請參閱 常見問題集：將增益集轉換成 VSPackage 擴充功能。

內容參數提供啟動精靈時所需的資訊，例如要使用的精靈類型、專案名稱、精靈項目的目錄等等。

有三種不同的精靈類型：

  • NewProject - 在方案中加入新專案

  • AddSubProject - 在現有專案中加入子專案

  • AddItem - 在現有專案中加入項目

這三種類型的精靈都是使用 IDTWizard 介面的 Execute 方法叫用。 Execute 方法的其中一個必要參數是 ContextParams。 每種類型都需要一組不同的 ContextParams 值，而且必須依照正確的順序，如下表中所列：

精靈類型

所使用的參數

NewProject

  • WizardType

  • ProjectName

  • LocalDirectory

  • InstallationDirectory

  • FExclusive

  • SolutionName

  • Silent

AddSubProject

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

AddItem

  • WizardType

  • ProjectName

  • ProjectItems

  • LocalDirectory

  • ItemName

  • InstallationDirectory

  • Silent

下表列出所有內容參數和其說明。

設定

描述

WizardType

表示精靈類型的常數。 有三種類型：

  • vsWizardNewProject (GUID = "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddItem (GUID = "{0F90E1D1-4999-11D1-B6D1-00A0C90F2744}")

  • vsWizardAddSubProject (GUID = "{0F90E1D2-4999-11D1-B6D1-00A0C90F2744}")

ProjectName

專案的名稱。

ProjectItems

指向精靈要在其上運作之 ProjectItems 集合的指標。 會依照專案的階層架構選擇傳遞給精靈。

LocalDirectory

本機系統上，精靈工作專案檔儲存的位置。

ItemName

要加入之項目的名稱。 ItemName 是使用者在 [加入項目] 對話方塊中輸入 (或預設接受) 的檔案名稱。 依據 VSDIR 檔案中所設定的旗標，這項設定可能是 NULL。

InstallationDirectory

安裝 Visual Studio 所在的目錄路徑。

FExclusive

指示專案是否應對自身獨佔的布林值 (Boolean)。 也就是說，不是在目前方案中加入專案，就是系統關閉目前的方案、建立新的方案，再於其中加入專案。

SolutionName

不含目錄部分或 .sln 副檔名的方案檔名稱 (.suo 檔名也是以此根目錄名稱為基礎)。如果 SolutionName 包含值 (也就是它不是空字串)，則 NewProject 精靈會在以 AddFromTemplate 加入專案前，呼叫 Create。 但是，如果 SolutionName 是空字串，就不需要在呼叫 AddFromTemplate 前呼叫 Create。

Silent

布林值，指出精靈是否以無訊息模式執行，而不顯示使用者介面 (UI)，並採用所有預設值。 Silent 的預設值為 True。

請參閱

參考

Execute

IDTWizard

概念

使用 .Vsdir 檔案將精靈加入至加入項目和新增專案對話方塊