Engine 類別

文字範本轉換引擎。

繼承階層架構

System.Object
Microsoft.VisualStudio.TextTemplating.Engine

命名空間： Microsoft.VisualStudio.TextTemplating
組件： Microsoft.VisualStudio.TextTemplating.10.0 (在 Microsoft.VisualStudio.TextTemplating.10.0.dll 中)

語法

'宣告
Public Class Engine _
    Implements ITextTemplatingEngine

public class Engine : ITextTemplatingEngine

public ref class Engine : ITextTemplatingEngine

type Engine =  
    class
        interface ITextTemplatingEngine
    end

public class Engine implements ITextTemplatingEngine

Engine 型別會公開下列成員。

建構函式

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

回頁首

方法

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

回頁首

欄位

	名稱	說明
	CacheAssembliesOptionString

回頁首

備註

文字範本轉換程序會將文字範本檔案視為輸入，並產生新的文字檔做為輸出。文字範本轉換引擎元件控制處理序，並且以一個「文字範本轉換主機」(Text Template Transformation Host) 與一個或多個文字範本指示詞處理器互動，以完成此處理序。如需詳細資訊，請參閱程式碼產生和 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)