商务咨询公司网站制作模板,学会网站开发需要多久,辽宁省交通投资建设集团网站,wordpress 子网站重命名示例代码#xff1a;示例代码__你必须懂的T4模板#xff1a;浅入深出.rar (一)什么是T4模板#xff1f; T4#xff0c;即4个T开头的英文字母组合#xff1a;Text Template Transformation Toolkit。 T4文本模板#xff0c;即一种自定义规则的代码生成器。根据业务模型可生…示例代码示例代码__你必须懂的T4模板浅入深出.rar (一)什么是T4模板 T4即4个T开头的英文字母组合Text Template Transformation Toolkit。 T4文本模板即一种自定义规则的代码生成器。根据业务模型可生成任何形式的文本文件或供程序调用的字符串。模型以适合于应用程序域的形式包含信息并且可以在应用程序的生存期更改 VS本身只提供一套基于T4引擎的代码生成的执行环境由下面程序集构成 Microsoft.VisualStudio.TextTemplating.10.0.dll Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll Microsoft.VisualStudio.TextTemplating.Modeling.10.0.dll Microsoft.VisualStudio.TextTemplating.VSHost.10.0.dll 便利工具 1、 T4Toolbox.msiCodePlex上开源的工具 a) 提供一些可以直接使用的代码生成器比如Enum SQL View、AzMan wrapper、LINQ to SQL classes、LINQ to SQL schema和Entity Framework DAL等。 b) 提供一些基于T4方面的VS的扩展当你安装之后在“Add New Item”对话框中就会多出一个命名为“Code Generation”的类别其中包括若干文件模板。 2、 T4 模板编辑器eg支持代码着色、智能提示 a) tangible T4 Editor 下载 b) Visual T4 下载 当然我们也可以通过VS2010中新增的扩展管理器Extension Manager来添加Vs扩展插件。扩展管理器Extension Manager这和Eclipse/Netbeans有些相似用户可以直接在IDE中从Visual Studio 库Visual Studio Gallery找到并下载扩展。通过VS的菜单Tools-Extension Manager,这里你可以添加删除已经安装的VS的扩展插件。打开界面如下 笔者在学习 T4 的时候使用过上面两个 T4 模板编辑器。稍作几点对比 a) tangible T4 Editor可选择安装内嵌的 UML 模板模型 b) 对于不是常用的dll( egEnvDTE.dll )tangible T4 Editor免费版和 Visual T4 都不支持导航并且所报的提示页不一样 tangible T4 Editor免费版中提示如下 Visual T4中则直接提示 但是在 Visual T4 中我们可以通过在程序集中引入 EnvDTE.dll 解决此错误的提示完成开发后可移除程序集引用并且还能完美的获得该程序集的智能提示功能如下图所示 同时我们也可以看到 Visual T4 中代码着色也更加贴近 VS 蓝色字体标注对象。 小结 就“代码着色”和“智能提示”方面Visual T4 工具表现更完美前提是必须主动在项目中引入对应程序集但目前最新版本存在缩进问题实在可惜悲愤中等更新。.可能你还想要tangible T4 Editor提供的 UML 模板模型呵呵……现在我本机同时装了这两款 T4编辑器暂时还没发现冲突。 (二)T4基本结构 T4模板可以分为指令块、文本块、控制块。 指令块 - 向文本模板化引擎提供关于如何生成转换代码和输出文件的一般指令。文本块 - 直接复制到输出的内容。控制块 - 向文本插入可变值并控制文本的条件或重复部件的程序代码不能在控制块中嵌套控制块。n 指令块 6个指令# template #、# parameter#、# assembly #、# import #、# include #、# output #、 其中 output 和 assembly 只能用在设计时模板。 1) T4 模板指令 # template [languageC#] [hostspecifictrue] [debugtrue] [culturecode] [inheritstemplateBaseClass] [compilerOptionsoptions] # 这里只说明下 inherits 属性其余属性在本文更合适的地方有进行说明。 inherits 指定模板的程序代码继承自另一个类该基类可以是由其他模板生成。 1) 运行时预处理过的文本模板中的继承 如果不指定 inherits 特性则会从您的文本模板生成基类和派生类。指定 inherits 特性时仅生成派生类。 2) 设计时文本模板中的继承 设计时模板会生成任何类型的“文本文件”此文件将组成 Visual Studio 项目的一部分。T4 模板引擎首先要将模板转换为中间程序代码文件中间代码文件将写入您的 %TEMP% (环境变量)目录。默认该生成的中间代码继承自 Microsoft.VisualStudio.TextTemplating.TextTransformation 类但你也可根据需求使用 inherits 特性指定派生于 TextTransformation 类的任何基类。 模板引擎生成转换类更详细的请参考本文后面的 何时编译编译过程 节。 2) T4 参数指令 # parameter typeFull.TypeName nameParameterName # 在 Visual Studio 文本模板中parameter 指令声明模板代码中从自外部上下文传入的值初始化的属性。可以声明任何远程类型的参数。也就是说类型必须使用SerializableAttribute进行声明或者必须从MarshalByRefObject派生。这样可以将参数值传递到在其中处理模板的AppDomain中。 如何使用及内部运作机制请查看我的另一篇文章 《译理解 T4 模板# parameter # 指令》 。 3) T4 导入指令 # import namespacenamespace # 4) T4 包含指令 # include filefilePath # a) 为了增加代码的可维护性将公用函数做为类功能块# 类功能控制块 #存放在单独的文件中该文件可以被 #include# 到一个或多个模板文件中。 b) 对于包含文件文件扩展名使用 .ttinclude可读性更好。以区分后缀为 .tt的运行时或设计时文本模板 5) T4 输出指令 # output extension.fileNameExtension [encodingencoding] # 运行时预处理文本模板中不需要 output 指令。应用程序通过调用TextTransform() 来获取已生成的字符串。 6) T4 程序集指令 # assembly name[assembly strong name|assembly file name] # 在预处理文本模板中assembly 指令无效。改为在 Visual Studio 项目中直接“添加引用”。 程序集名称应为以下各项之一 GAC 中程序集的强名称例如 System.Xml.dll。还可以使用长名称例如 nameSystem.Xml, Version4.0.0.0, Cultureneutral,PublicKeyTokenb77……。程序集的绝对路径可以使用 $(variableName) 语法引用 Visual Studio 或MSBuild变量如 $(SolutionDir)以及使用 %VariableName% 来引用环境变量。 另给出一些常用的 【生成命令和属性的宏】 $(ConfigurationName) 当前项目配置的名称如“Debug”。 $(PlatformName) 当前项目平台的名称如“Win32”。 $(ProjectName) 项目的基本名称。 $(TargetDir) 生成的主输出文件的目录定义为驱动器 路径包括尾部的反斜杠“\”。 $(TargetName) 生成的主输出文件的基本名称。 $(FrameworkDir) 安装 .NET Framework 的目录。 $(FrameworkVersion) Visual Studio 使用的 .NET Framework 版本。 $(WebDeployPath) 从 Web 部署根到项目输出所属于的位置的相对路径。返回与RelativePath相同的值。 $(WebDeployRoot) 指向localhost位置的绝对路径。例如c:\inetpub\wwwroot。 n 控制块 有三种类型的控制块根据其左括号对它们进行区分 1. # 标准控制块 # 可以包含语句。 2. # 表达式控制块 # 将一个可以计算为字符串的表达式括起来,用于提供要写入“输出”文件的字符串的代码。 3. # 类功能控制块 # 可以使用类功能控制块向文本模板添加方法、属性、字段甚至是嵌套类。必须作为文件中的最后一个块显示或者用# include #引入外部文件。 注意 1) 始终使用 {...}花括号来包含内嵌的嵌套语句否则会报错。哪怕花括号中只有一句代码 2) 控制块不能互相嵌套。必须先终止之前的控制块然后才能打开另一个。 (三)设计时模板和运行时模板 T4文本模板分为设计时模板和运行时模板 n 添加模板 设计时模板文本模板优势当需求变化时可以根据业务需求调整模型输入按照指定规则将“模型”生成任何类型的“文本文件”例如网页、资源文件或任何语言的程序源代码。模型是描述应用程序特定方面的数据源。它可以是任何形式、任何类型的文件或数据库。如数据库、配置文件、UML 模型、DSL 模型或其他源 a) VS中新建文件——常规——文本模板。如图 该模板文件中已包含下列指令 # template debugfalse hostspecificfalse languageC# # # output extension.txt # b) 或则添加“纯文本文件”并设置下图属性加入相关指令。后缀推荐改为标准的 *.tt 设计时模板: TextTemplatingFileGenerator 运行时模板已预处理的文本模板 优势当需求变化时可以根据业务需求调整模型输入在运行时按照指定规则将“模型”生成为“文本字符串”。 VS中新建文件——常规——已预处理的文本模板。该模板文件包含指令# template languageC# # 或则添加“纯文本文件”并设置相应属性加入相关指令。运行时模板:TextTemplatingFilePreprocessor n 何时编译编译过程 何时编译在下列任何一种情况下将执行模板同时生成附属文件生成的文件将作为项目的一部分编译。属性框----生成操作编译 1) 编辑模板模板有异动且没有被保存当前编辑模板失去焦点。 2) 保存模板。 3) 在“解决方案资源管理器”工具栏中单击“转换所有模板”。转换解决方案中的所有模板。 4) 右击“解决方案资源管理器”中的一个或多个模板文件然后选择“运行自定义工具”。 编译过程设计时模板 1) 文本模板转换引擎将“文本模板”转换为可执行的cs代码——“转换类”。转换类(*.cs)存于临时目录下。临时目录在“环境变量”中设置右键“我的电脑”—“属性”—“高级系统设置”—“高级”选项卡中“环境变量”—TEMP变量 命名空间Microsoft.VisualStudio.TextTemplating 随机码 基类Microsoft.VisualStudio.TextTemplating.TextTransformation 类名GeneratedTextTransformation 2) 引擎编译生成的“转换类”生成dlldll存于临时目录下。具体是哪个dll可以在模板的“调试环境”下使用System.Reflection.Assembly.GetExecutingAssembly();获取。 3) 执行已编译的转换类生成“文件”。新文件会在“解决方案资源管理器”中出现在文本模板文件下。 运行时模板 1) 运行时模板没有# output #指令文本模板引擎将“运行时模板”直接编译为cs文件作为项目的一部分编译。新文件会在“解决方案资源管理器”中出现在文本模板文件下。 命名空间默认为所属程序集的命名空间 基类模板文件名 Base 类名模板文件名PreTextTemplateTest.tt——注意是“分部类” 2) 生成的代码文件随着项目一起编译并可在应用程序中通过调用生成类中的TransformText() 方法输出“文本字符串”。 另外若要在特定命名空间中放置模板转换生成的类需设置模板文件的“自定义工具命名空间”属性。 注意事项1) 控制块使用陷进 TransformText() 方法是由模板引擎将模板中的所有“控制块”代码包括“包含的模板”组合生成。所以在使用控制块时应注意以下几点 a) 语言只能使用一种语言。 b) 局部变量确保局部变量的名称不会冲突。 2) 文本模板在单独的AppDomain中运行 请注意文本模板在与主应用程序分开的AppDomain中运行。在大多数情况下这并不重要但在某些复杂的情况下您可能会发现一些限制。例如如果要从单独的服务将数据传入模板或从中传出数据则该服务必须提供可序列化的 API。 (四)技巧 l 快速编写模板 以生成文件为原型然后逐步插入用于改变结果的控制块。 l T4文本模板的断点调试 注册表设置DbgJITDebugLaunchSetting值为 2。(x86系统): HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework (x64 系统): HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework 为template指令添加debugtrue特性# template debugtrue#命令# System.Diagnostics.Debugger.Launch();# 在模板执行到特定点启动调试器。如果用Debugger.Break()启动调试器在调试完后会导致 VS 奔溃。 #System.Diagnostics.Debugger.Break();# 启动调试器后使用此命令在后续特定点处再次进入调试模式相当于断点。 使用方法必须使用“Debugger.Launch()”命令启动调试器如下图启动新实例或使用已存在的VS附加。注意若此处点击取消则将关闭当前IDE调试完后可以不用中断调试不影响模板编辑当再次编译模板时如果存在“Debugger.Break()”命令则自动进入调试模式。 l 向模板传递参数的两种方法 使用 # parameter# 指令引入参数由模板引擎生成属性访问代码。详细请看 《译理解 T4 模板# parameter # 指令》 。在构造函数中传递参数。只适用于运行时模板此种模板生成的代码以分部类的形式编写。可以在项目的另一个文件中创建同一个类的其他部分该文件可以包含一个带参数的构造函数、若干属性和函数在调用 TransformText() 实例方法前进行初始化。 l 使用模板继承共享内容 可以通过编写基类模板可以是抽象模板在文本模板之间共享内容。使用#template# 指令的 inherits 特性指定基类。 l 运行时调用设计时模板返回字符串 调用 Microsoft.VisualStudio.TextTemplating.Engine 的 ProcessTemplate 方法。 publicstring ProcessTemplate( string content, ITextTemplatingEngineHost host ) content 参数指定文本模板的内容eg 使用System.IO.File.ReadAllText(Path) 进行读取 host 参数指定的宿主必须是实现 ITextTemplatingEngineHost 的类。这是由模板引擎回调的。宿主必须能记录错误、解析对程序集和包含文件的引用、提供可在其中执行模板的应用程序域并为每条指令调用相应的处理器。 演练创建自定义文本模板宿主 (五)常用方法 n 模板基类提供的方法 设计时模板继承TextTransformation抽象类 运行时模板默认继承自动生成的基类 Write() 和WriteLine() 方法写入目的输出文本的三种方式 a) 文本块 b) 表达式控制块 # 变量 # c) 标准控制块 # Write() | WriteLine() #因为控制块不能嵌套所以此种方式比# 变量 #书写更优雅。 输出文本缩进设置可以使用缩进方法设置文本模板输出的格式。 a) PushIndent(string indent) 添加指定格式内部会将字符长度加入到缓存变量indentLengths列表Listint。 b) PopIndent() 以“堆栈先进后出”形式移除格式内部按indentLengths列表中存的字符长度进行移除。 c) ClearIndent() 删除所有缩进。 注意格式用完后要注意清除否则可能出现模板中的空行会生成 Write(“\r\n”) 中间代码最终造成将缩进的格式错误输出到了目的文件。 Eg: 错误报告若要在 Visual Studio 错误窗口中放置错误消息和警告消息可以使用以下方法 # this.Error(An error message); # # Warning(A warning message); # n 使用执行模板的主机例如 Visual Studio公开的方法和属性。这适用于常规文本模板而不是预处理过的文本模板。 首先给 template 指令添加hostspecifictrue 特性以便使用this.Host对象。 (Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost)接口提供方法 使用this.Host.ResolvePath()从相对路径名打开文件使用LogErrors() 显示错误消息如下图 使用 Visual Studio 中提供的服务加载EnvDTE.dll EnvDTE是組件包裝 COM 程式庫其中包含了 Visual Studio 核心 Automation 的物件及成員。 引入 EnvDTE.dll 组件后应按下图“属性”进行设置 示例 # assembly nameEnvDTE # # IServiceProvider serviceProvider (IServiceProvider)this.Host; EnvDTE.DTEdte (EnvDTE.DTE) serviceProvider.GetService(typeof(EnvDTE.DTE)); dte.Solution.SaveAs(C:\\backup_Solution); #转载于:https://www.cnblogs.com/TF12138/p/4191484.html
