Engine 類別

發行項
10/31/2012

文字範本轉換引擎。

繼承階層架構

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)