Engine 类

项目
08/12/2011

文本模板转换引擎。

继承层次结构

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 的浅表副本。（继承自 Object。）
	PreprocessTemplate	基于模板生成代码，该代码在编译和运行时将生成模板输出。
	ProcessTemplate	转换文本模板文件的内容以产生生成文本输出。
	ToString	返回表示当前对象的字符串。（继承自 Object。）

页首

字段

	名称	说明
	CacheAssembliesOptionString

页首

备注

文本模板转换进程将文本模板文件作为输入，并生成一个新的文本文件作为输出。文本模板转换引擎组件控制该进程，并与文本模板转换主机和一个或多个文本模板指令处理器进行交互，以完成此过程。有关更多信息，请参见代码生成和 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)