Microsoft.VisualStudio.TextTemplating 命名空间

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

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

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

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

• 自定义 T4 文本转换

• ITextTemplatingEngineHost

• DirectiveProcessor

• RequiresProvidesDirectiveProcessor

类

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

接口

	接口	说明
	IDebugTextTemplatingEngine
	IDebugTransformationRun
	IDebugTransformationRunFactory
	IDirectiveProcessor	指令处理器的接口。
	IDirectiveProcessorMetadata	DirectiveProcessors提供元数据。若要通过MEF导入衰变/秒的宿主可以使用此标准元数据。
	IRecognizeHostSpecific	指令处理器实现此方法以获取文本模板中 HostSpecific 标志的状态。
	ITextTemplatingEngine	文本模板转换引擎的接口。
	ITextTemplatingEngineHost	用于转换文本模板的主机接口。这可用于指令处理器，也可以通过文本模板进行访问。
	ITextTemplatingOrchestrator
	ITextTemplatingSession	可用于将信息从指令处理器传输到文本模板。
	ITextTemplatingSessionHost	由文本模板化主机实现，使调用方可获取表示当前会话的对象。会话表示文本模板的执行序列。会话对象可用于将信息从主机传递到文本模板代码。