Microsoft.VisualStudio.TextTemplating 命名空间

Microsoft.VisualStudio.TextTemplating 命名空间提供了用于文本模板转换功能的类。文本模板转换引擎集成到 Visual Studio 中，并将文本模板文件转换为生成的文本输出文件。

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

文本模板转换过程有两个步骤。在第一步中，文本模板转换引擎将创建一个称为生成的转换类的类。在第二步中，该引擎编译和执行生成的转换类，以产生生成的文本输出。生成的转换类包括文本模板的代码（也就是语句、表达式、类功能）、文本模板中的样本文本以及调用指令处理器的结果。有关更多信息，请参见编写 T4 文本模板。

高级用户可能希望实现自己的文本模板转换引擎主机或指令处理器。有关更多信息，请参见：

• 自定义 T4 文本转换

• ITextTemplatingEngineHost

• DirectiveProcessor

• RequiresProvidesDirectiveProcessor

类

	类	说明
	AssemblyCacheMonitor	监视程序集缓存的状态。
	DirectiveProcessor	具体指令处理器的抽象基类。
	DirectiveProcessorException	当处理指令出现错误时，由文本模板转换引擎引发的异常。
	EncodingHelper	一个实用工具类，可从文件的字节顺序标记中获取其编码。
	Engine	文本模板转换引擎。
	ParameterDirectiveProcessor	指令处理器，用于将简单的可序列化参数从调用方或主机路由到模板。
	RequiresProvidesDirectiveProcessor	定义和实施所调用设计模式需要/提供的指令处理器的抽象基类。
	TextTemplatingSession	文本转换会话接口的普通实现
	TextTransformation	所有生成的转换类的抽象基类。此类还提供用于文本模板代码的实用工具方法和属性。
	ToStringHelper	一个实用工具类，用于生成 Object 的区域性特定 String 表示形式。

接口

	接口	说明
	IRecognizeHostSpecific	指令处理器实现此方法以获取文本模板中 HostSpecific 标志的状态。
	ITextTemplatingEngine	文本模板转换引擎的接口。
	ITextTemplatingEngineHost	用于转换文本模板的主机接口。这可用于指令处理器，也可以通过文本模板进行访问。
	ITextTemplatingSession	可用于将信息从指令处理器传输到文本模板。
	ITextTemplatingSessionHost	由文本模板化主机实现，使调用方可获取表示当前会话的对象。会话表示文本模板的执行序列。会话对象可用于将信息从主机传递到文本模板代码。