自訂 T4 文字轉換

文字模板是 Visual Studio 的一項功能，可讓您透過轉換程式產生程式碼或其他文字檔。 使用 Visual Studio SDK，您可以自訂文字模板指示詞處理器或文字模板主機來擴充預設範本轉換程式。

本節內容

文字範本轉換程式︰描述文字轉換的運作方式，並說明範本主機和指示詞處理器的角色。

建立自訂 T4 文字模板指示詞處理器︰指示詞處理器會處理範本中的指示詞，例如 <#@template#>. 它在範本編譯期間執行，而且可以載入組件和其他資源。 它也可以插入程式碼，以在執行時間載入資源。 藉由定義您自己的指示詞處理器，您可以減少範本的複雜度。

在 VS 擴充功能中叫用文字轉換︰如果您要撰寫 Visual Studio 延伸模組，例如功能表命令或事件處理常式，您的延伸模組可以使用文字模板化服務來轉換任何文字模板。 您可以使用 Session 物件將參數資料傳遞至範本，並使用 <#@parameter#> 指示詞從範本內取得值。

使用自訂主機處理文字模板︰當文字模板的程式碼執行時，主機會提供外部檔案和應用程式狀態的存取權。 例如，在 Visual Studio 中執行文字轉換的主機可以提供方案總管的存取權。 它也會在錯誤訊息視窗中顯示錯誤。 如果您想要在不同的內容中執行文字轉換，您可以定義自己的主機，以存取該內容中可用的服務。

如果您要撰寫 Visual Studio 延伸模組，請考慮使用現有的文字轉換服務，而不是撰寫您自己的主機。 如需詳細資訊，請參閱在 VS 延伸模組中叫用文字轉換。

相關內容

• 撰寫 T4 文字範本提供文字範本指示詞和控制區塊的語法。