共用方式為


自訂 T4 文字轉換

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

在本節中

  • 文字範本轉換流程
    描述文字轉換的運作方式,並說明範本主應用程式及指示詞處理器的角色。

  • 建立自訂 T4 文字範本指示詞處理器
    指示詞處理器會處理範本中的指示詞,例如 <#@template#>.。它可以在編譯範本時執行,並且載入組件和其他資源。此外,也可以在執行階段插入會載入資源的程式碼。您可以定義自己的指示詞處理器,降低範本的複雜度。

  • 叫用 VS 擴充功能中的文字轉換
    如果您要撰寫功能表命令或事件處理常式這類 Visual Studio 擴充功能,該擴充功能可以使用文字範本化服務來轉換任何文字範本。使用 Session 物件可以將參數資料傳入範本,使用 <#@parameter#> 指示詞可以從範本中取得值。

  • 使用自訂主機處理文字範本
    當文字範本的程式碼執行時,主應用程式 (Host) 會讓程式碼能夠存取外部檔案及應用程式 (Application) 的狀態。例如,在 Visual Studio 中執行文字轉換的主應用程式會讓您存取方案總管,也會在錯誤訊息視窗中顯示錯誤。如果您想要在不同的內容中執行文字轉換,可以定義自己的主應用程式,以便存取可在該內容中使用的服務。

    如果您要撰寫 Visual Studio 擴充功能,請考慮使用現有的文字轉換服務,而不是撰寫自己的主應用程式。如需詳細資訊,請參閱叫用 VS 擴充功能中的文字轉換

參考

撰寫 T4 文字範本

提供文字範本指示詞及控制區塊的語法。