Engine 类

项目
10/25/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 的浅表副本。（继承自 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)