Microsoft.VisualStudio.TextTemplating 命名空间提供了用于文本模板转换功能的类。 文本模板转换引擎集成到 Visual Studio 中,并将文本模板文件转换为生成的文本输出文件。
文本模板转换进程将文本模板文件作为输入,对输入执行转换,并生成一个新的文本文件作为输出。 引擎组件控制该进程,并与文本模板转换主机和一个或多个文本模板指令处理器进行交互,以完成此过程。 有关详细信息,请参阅代码生成和 T4 文本模板。
文本模板转换过程有两个步骤。 在第一步中,文本模板转换引擎将创建一个称为生成的转换类的类。 在第二步中,该引擎编译和执行生成的转换类,以产生生成的文本输出。 生成的转换类包括文本模板的代码(也就是语句、表达式、类功能)、文本模板中的样本文本以及调用指令处理器的结果。 有关详细信息,请参阅编写 T4 文本模板。
高级用户可能希望实现自己的文本模板转换引擎主机或指令处理器。 有关详细信息,请参阅:
类
类 | 说明 | |
---|---|---|
![]() |
AssemblyCacheMonitor | 监视程序集缓存的状态。 |
![]() |
DirectiveProcessor | 具体指令处理器的抽象基类。 |
![]() |
DirectiveProcessorException | 当处理指令出现错误时,由文本模板转换引擎引发的异常。 |
![]() |
EncodingHelper | 一个实用工具类,可从文件的字节顺序标记中获取其编码。 |
![]() |
Engine | 文本模板转换引擎。 |
![]() |
ParameterDirectiveProcessor | 指令处理器,用于将简单的可序列化参数从调用方或主机路由到模板。 |
![]() |
RequiresProvidesDirectiveProcessor | 定义和实施所调用设计模式需要/提供的指令处理器的抽象基类。 |
![]() |
ShadowCopyMonitor | 监视卷影复制的程序集的状态以供宿主使用。 |
![]() |
TextTemplatingSession | 文本转换会话接口的普通实现 |
![]() |
TextTransformation | 所有生成的转换类的抽象基类。此类还提供用于文本模板代码的实用工具方法和属性。 |
![]() |
ToStringHelper | 一个实用工具类,用于生成 Object 的区域性特定 String 表示形式。 |
接口
接口 | 说明 | |
---|---|---|
![]() |
IRecognizeHostSpecific | 指令处理器实现此方法以获取文本模板中 HostSpecific 标志的状态。 |