DZone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
Refcards Trend Reports Events Over 2 million developers have joined DZone. Join Today! Thanks for visiting DZone today,
Edit Profile Manage Email Subscriptions Moderation Admin Console How to Post to DZone Article Submission Guidelines
View Profile
Sign Out
Refcards
Trend Reports
Events
Zones
Culture and Methodologies Agile Career Development Methodologies Team Management
Data Engineering AI/ML Big Data Data Databases IoT
Software Design and Architecture Cloud Architecture Containers Integration Microservices Performance Security
Coding Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones AWS Cloud
by AWS Developer Relations
Culture and Methodologies
Agile Career Development Methodologies Team Management
Data Engineering
AI/ML Big Data Data Databases IoT
Software Design and Architecture
Cloud Architecture Containers Integration Microservices Performance Security
Coding
Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance
Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones
AWS Cloud
by AWS Developer Relations
The Latest "Software Integration: The Intersection of APIs, Microservices, and Cloud-Based Systems" Trend Report
Get the report

T4 Code Generation with Visual Studio 2010

Dane Morgridge user avatar by
Dane Morgridge
·
Jul. 21, 10 · Interview
Like (0)
Save
Tweet
Share
7.46K Views

Join the DZone community and get the full member experience.

Join For Free

T4 (Text Template Transformation Toolkit) is a code generation system that has been around for a while, bit is a little bit more accessible with Visual Studio 2010.  It allows you to quickly generate code for your application and it is used in several places behind the scenes in Visual Studio.  It can be a very powerful tool when you have code that needs to be reused but also configured at the same time.  I have a CodePlex project that is a T4 template to generate a data layer for the ADO.NET Entity Framework if you would like a more advanced sample.  You can find it at http://efrepository.codeplex.com.

To get started, add a new item to your project and select "Text Template".  You will get a dialog to set the name with a .tt extension.  I'll use "TestTemplate.tt" for this example.  The newly created file will have the following text:

<#@ template debug="false" hostspecific="false" language="C#" #>
<#@ output extension=".txt" #

Notice that the language is set to C# and the output extension is ".txt".  The default file name that gets generated will be the file name of the template itself plus the output extension.  In this case the generated file would be called "TestTemplate.txt". If we change the output extension to ".cs", the file would be "TestTemplate.cs".

You can use really any C# code you want inside this file to generate your code.  If we add text to the file it will get written to the output file and any code blocks you enter will be evaluated when the template gets processed.  With a little work, you can get some really cool results. 

Code blocks are delineated with "<# #>" and the overall structure resembles ASP.NET.  You can import namespaces and even use include files.  Below is a couple of lines from my efrepository T4 tem

<#@ include file="EF.Utility.CS.ttinclude"#>
<#@ import namespace="System.IO" #>

The include files are also T4 templates and the namespace you can use are standard .NET namespaces. They can be custom code or framework libraries.

You can also specify methods within your template that can be called from the template itself.  Methods must be surrounded by a "<#+" block:

<#+
string DoSomething(string param)
{
// Do something and return a string
}
#>

The templates are also relatively easy to read, so it's not too hard to figure out what someone is doing if you are looking at one already created. T4 is very powerful and when you get the hang of it, it can really make things easy when doing code generation.

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • Choosing the Right Framework for Your Project
  • 11 Observability Tools You Should Know
  • Testing Level Dynamics: Achieving Confidence From Testing
  • Integrate AWS Secrets Manager in Spring Boot Application

Comments

Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends: