文字範本是 Visual Studio 的一項功能,可讓您透過轉換程式產生程式代碼或其他文字檔案。 使用 Visual Studio SDK,您可以自訂文字範本指示詞處理器或文字範本主機,以擴充預設範本轉換程式。
本節中
文字範本轉換程序:說明文字轉換的運作方式,並說明範本主機和指示詞處理器的角色。
建立自訂 T4 文字範本指令處理器:指令處理器會處理範本中的指令,例如 <#@template#>. 它在範本編譯期間執行,並且可以載入元件和其他資源。 它也可以插入將在執行階段載入資源的程式碼。 透過定義您自己的指令處理器,您可以降低範本的複雜性。
在 VS 延伸模組中叫用文字轉換:如果您要撰寫 Visual Studio 延伸模組,例如功能表命令或事件處理常式,您的延伸模組可以使用文字範本服務來轉換任何文字範本。 您可以使用 Session 物件將參數資料傳遞至範本,並使用 指示 <#@parameter#> 詞從範本內取得值。
使用自訂主機處理文字範本:當文字範本的程式碼執行時,主機會提供對外部檔案和應用程式狀態的存取。 例如,在 Visual Studio 中執行文字轉換的主機可以提供 解決方案總管的存取權。 它還會在錯誤訊息視窗中顯示錯誤。 如果您想要在不同的環境定義中執行文字轉換,您可以定義自己的主機,以提供對該環境定義中可用服務的存取權。
如果您要撰寫 Visual Studio 延伸模組,請考慮使用現有的文字轉換服務,而不是撰寫您自己的主機。 如需詳細資訊,請參閱 在 VS 延伸模組中叫用文字轉換。
相關內容
- 編寫 T4 文字範本 提供文字範本指令和控制區塊的語法。