Microsoft.VisualStudio.TextTemplating 命名空间

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

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

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

高级用户可能希望实现自己的文本模板转换引擎主机或指令处理器。 有关详细信息,请参阅:

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

接口

  接口 说明
公共接口 IRecognizeHostSpecific 指令处理器实现此方法以获取文本模板中 HostSpecific 标志的状态。