Microsoft.VisualStudio.TextTemplating 命名空間

Microsoft.VisualStudio.TextTemplating 命名空間提供文字範本轉換功能的類別。文字範本轉換引擎已整合至 Visual Studio 中，而且會將文字範本檔案轉換為產生的文字輸出檔。

文字範本轉換程序會將文字範本檔案視為輸入、在輸入執行轉換，並產生新的文字檔做為輸出。引擎元件控制處理序，並且與文字範本轉換主機與一或多個文字範本指示詞處理器互動，以完成此處理序。如需詳細資訊，請參閱程式碼產生和 T4 文字範本。

文字範本轉換處理序有兩個步驟。在第一個步驟中，文字範本轉換引擎會建立做為所產生的轉換類別之參考的類別。在第二個步驟中，引擎會編譯並執行所產生的轉換類別，以產生所產生的文字輸出。產生的轉換類別包含文字範本的程式碼，也就是陳述式、運算式、類別功能及文字範本中的未定案文字，以及呼叫指示詞處理序的結果。如需詳細資訊，請參閱撰寫 T4 文字範本。

進階的使用者可以實作自己的文字範本轉換引擎主機或指示詞處理器。如需詳細資訊，請參閱：

• 自訂 T4 文字轉換

• ITextTemplatingEngineHost

• DirectiveProcessor

• RequiresProvidesDirectiveProcessor

類別

	類別	說明
	AssemblyCacheMonitor	監視組件快取的狀態。
	DirectiveProcessor	具體指示詞處理器的抽象基底類別。
	DirectiveProcessorAttribute
	DirectiveProcessorException	如果處理指示詞時發生錯誤，文字範本轉換引擎所擲回的例外狀況。
	EncodingHelper	公用程式類別，會從檔案的位元組順序標記取得檔案的編碼方式。
	Engine	文字範本轉換引擎。
	ParameterDirectiveProcessor	指示詞處理器，將簡單可序列化參數從呼叫端或主機路由至範本。
	RequiresProvidesDirectiveProcessor	指示詞處理器的抽象基底類別，定義及實作所謂的 requires/provides 設計模式。
	ServiceProviderExtensions	包含與 T4 範本相關 IServiceProvider 之擴充功能的類別。
	ShadowCopyMonitor	監視陰影複製的組件狀態以供主應用程式使用。
	SupportedDirectiveAttribute
	TextTemplatingSession	文字轉換工作階段介面的一般實作
	TextTransformation	所有產生之轉換類別的抽象基底類別。這個類別也提供用於文字範本程式碼的公用程式方法和屬性。
	ToStringHelper	公用程式類別，可用來產生 Object 的特定文化特性表示做為 String。
	TransformedAllTemplatesEventArgs
	TransformingAllTemplatesEventArgs

介面

	介面	說明
	IDebugTextTemplatingEngine
	IDebugTransformationRun
	IDebugTransformationRunFactory
	IDirectiveProcessor	指示詞處理器的介面。
	IDirectiveProcessorMetadata	DirectiveProcessors 提供的中繼資料。若要透過 MEF 匯入衰變更 Pages Output/sec 的主應用程式可以使用這個標準中繼資料。
	IRecognizeHostSpecific	指示詞處理器會實作這個方法，以取得文字範本中 HostSpecific 旗標的狀態。
	ITextTemplatingEngine	文字範本轉換引擎的介面。
	ITextTemplatingEngineHost	轉換文字範本之主應用程式的介面。這可以供指示詞處理器使用，也可以由文字範本存取。
	ITextTemplatingOrchestrator
	ITextTemplatingSession	可以用來將資訊從指示詞處理器傳輸至文字範本。
	ITextTemplatingSessionHost	由文字樣板化主機所實作，讓呼叫端取得代表目前工作階段的物件。工作階段表示文字範本的一連串執行作業。工作階段物件可以用來將資訊從主機傳遞給文字範本的程式碼。