T4 文字範本指示詞

更新：2011 年 3 月

指示詞會提供指令給文字範本轉換引擎。

指示詞的語法如下：

<#@ DirectiveName [AttributeName = "AttributeValue"] ... #>

所有屬性值都必須包含在雙引號中。 如果值本身包含引號，則必須以 \ 字元逸出。

指示詞通常是範本檔案或被納入的檔案中的第一個項目。 在 <#...#> 程式碼區塊內，或 <#+...#> 類別功能區塊後面，都不應該放置指示詞。

• T4 範本指示詞

  <#@ template [language="VB"] [hostspecific="true"] [debug="true"] [inherits="templateBaseClass"] [culture="code"] [compilerOptions="options"] #>
  

• T4 參數指示詞

  <#@ parameter type="Full.TypeName" name="ParameterName" #>
  

• T4 輸出指示詞

  <#@ output extension=".fileNameExtension" [encoding="encoding"] #>
  

• T4 組件指示詞

  <#@ assembly name="[assembly strong name|assembly file name]" #>
  

• T4 匯入指示詞

  <#@ import namespace="namespace" #>
  

• T4 包含指示詞

  <#@ include file="filePath" #>
  

此外，您也可以建立自己的指示詞。 如需詳細資訊，請參閱建立自訂文字範本指示詞處理器。 如果使用 Visualization and Modeling SDK 建立網域指定的語言 (DSL)，則會產生指示詞處理器做為 DSL 的一部分。

變更記錄

日期	記錄	原因
2011 年 3 月	將內容分割成子主題。	資訊加強。
2010 年 6 月	在 assembly 指示詞中使用 $(SolutionDir)。 在前置處理過的範本中改用專案參考。 加入 <#@Parameter#>。 加入有關繼承，以及有關在範本中建置參考之組件的注意事項。	客戶回函。