共用方式為


Engine 類別

文字範本轉換引擎。

繼承階層架構

System.Object
  Microsoft.VisualStudio.TextTemplating.Engine

命名空間:  Microsoft.VisualStudio.TextTemplating
組件:  Microsoft.VisualStudio.TextTemplating.11.0 (在 Microsoft.VisualStudio.TextTemplating.11.0.dll 中)

語法

'宣告
Public Class Engine _
    Implements IDebugTextTemplatingEngine, ITextTemplatingEngine
public class Engine : IDebugTextTemplatingEngine, ITextTemplatingEngine
public ref class Engine : IDebugTextTemplatingEngine, ITextTemplatingEngine
type Engine =  
    class
        interface IDebugTextTemplatingEngine
        interface ITextTemplatingEngine
    end
public class Engine implements IDebugTextTemplatingEngine, ITextTemplatingEngine

Engine 型別會公開下列成員。

建構函式

  名稱 說明
公用方法 Engine 初始化 Engine 類別的新執行個體。

回頁首

方法

  名稱 說明
公用方法 Equals 判斷指定的物件是否等於目前物件。 (繼承自 Object)。
受保護的方法 Finalize 允許物件在記憶體回收進行回收之前,嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
公用方法 GetHashCode 做為特定型別的雜湊函式。 (繼承自 Object)。
公用方法 GetType 取得目前執行個體的 Type。 (繼承自 Object)。
受保護的方法 MemberwiseClone 建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
公用方法 PrepareTransformationRun 準備一個 IDebugTransformationRun 物件執行範本。
公用方法 PreprocessTemplate 會從範本的程式碼,請在 中,在編譯和執行時,會產生範本的輸出。
公用方法 ProcessTemplate 轉換文字範本檔的內容,以產生所產生的文字輸出。
公用方法 ToString 傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

欄位

  名稱 說明
公用欄位靜態成員 CacheAssembliesOptionString CacheAssemblies 選取字串。
公用欄位靜態成員 TemplateFileParameterName

回頁首

備註

文字範本轉換流程會接受文字範本檔做為輸入並產生新文字檔做為輸出。文字範本轉換引擎元件控制這個處理序並使用 文字範本轉換主應用程式 互動,以及一或多個文字範本指示詞處理器完成這個程序。如需詳細資訊,請參閱 程式碼產生和 T4 文字範本

提示提示

如果您正在撰寫在 Visual Studio內執行的封裝或擴充功能,請考慮使用文字範本化服務而不是撰寫自己的主應用程式。如需詳細資訊,請參閱叫用 VS 擴充功能中的文字轉換

範例

下列範例示範如何建立 Engine 的執行個體,並且呼叫 ProcessTemplate 來轉換文字範本。

這個程式碼範例是 ITextTemplatingEngineHost 介面完整範例的一部分。

Engine engine = new Engine();

//read the text template
string input = File.ReadAllText(templateFileName);

//transform the text template
string output = engine.ProcessTemplate(input, host);
Dim engine As Engine = New Engine()

'read the text template
Dim input As String = File.ReadAllText(templateFileName)

'transform the text template
Dim output As String = engine.ProcessTemplate(input, host)

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.TextTemplating 命名空間

ITextTemplatingEngineHost

其他資源

使用自訂主機處理文字範本

逐步解說:建立自訂文字範本主機

程式碼產生和 T4 文字範本