t4mvc Wiki Rss Feed

Updated Wiki: T4MVC_History

davidebbo — Sun, 19 May 2013 21:03:19 GMT

T4MVC change history

3.6.5 (5-19-2013)

Use Controller constructor with least number of params. https://t4mvc.codeplex.com/workitem/22

3.6.4 (5-08-2013)

Added support for checking files out with Perforce P4VS. https://t4mvc.codeplex.com/discussions/442992

3.6.3 (5-08-2013)

Fix assembly signing

3.6.2 (5-07-2013)

Avoid identifier conflict when content file names are similar. https://t4mvc.codeplex.com/discussions/441214

3.6.1 (5-03-2013)

Make actionresult classes partial. https://t4mvc.codeplex.com/SourceControl/network/forks/duncans/T4MVC/contribution/4632

3.6.0 (4-26-2013)

Add support for task based actions. https://t4mvc.codeplex.com/SourceControl/network/forks/kev_bite/T4mvcTaskBasedActions/contribution/4564

3.5.4 (4-22-2013)

Make action results internal to avoid cross project conflicts

3.5.3 (4-19-2013):

Add support for portable areas without a standard area folder

3.5.2 (3-07-2013):

Add support for inherited controller attributes. http://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/4194

3.5.1 (2-25-2013):

If static files include a timestamp, previously for minified CSS- and JavaScript-files the timestamp was generated by taking the last change time of the unminified file. https://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4122

3.5.0 (2-08-2013):

Sign T4MVCExtensions.dll http://t4mvc.codeplex.com/discussions/432534
Call T4Extension.TimestampString through delegate for unit testing http://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4040

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_History

davidebbo — Wed, 08 May 2013 06:36:37 GMT

T4MVC change history

3.6.2 (5-07-2013)

Avoid identifier conflict when content file names are similar. https://t4mvc.codeplex.com/discussions/441214

3.6.1 (5-03-2013)

Make actionresult classes partial. https://t4mvc.codeplex.com/SourceControl/network/forks/duncans/T4MVC/contribution/4632

3.6.0 (4-26-2013)

Add support for task based actions. https://t4mvc.codeplex.com/SourceControl/network/forks/kev_bite/T4mvcTaskBasedActions/contribution/4564

3.5.4 (4-22-2013)

Make action results internal to avoid cross project conflicts

3.5.3 (4-19-2013):

Add support for portable areas without a standard area folder

3.5.2 (3-07-2013):

Add support for inherited controller attributes. http://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/4194

3.5.1 (2-25-2013):

If static files include a timestamp, previously for minified CSS- and JavaScript-files the timestamp was generated by taking the last change time of the unminified file. https://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4122

3.5.0 (2-08-2013):

Sign T4MVCExtensions.dll http://t4mvc.codeplex.com/discussions/432534
Call T4Extension.TimestampString through delegate for unit testing http://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4040

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_History

davidebbo — Fri, 03 May 2013 22:29:53 GMT

T4MVC change history

3.6.1 (5-03-2013)

Make actionresult classes partial. https://t4mvc.codeplex.com/SourceControl/network/forks/duncans/T4MVC/contribution/4632

3.6.0 (4-26-2013)

Add support for task based actions. https://t4mvc.codeplex.com/SourceControl/network/forks/kev_bite/T4mvcTaskBasedActions/contribution/4564

3.5.4 (4-22-2013)

Make action results internal to avoid cross project conflicts

3.5.3 (4-19-2013):

Add support for portable areas without a standard area folder

3.5.2 (3-07-2013):

Add support for inherited controller attributes. http://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/4194

3.5.1 (2-25-2013):

If static files include a timestamp, previously for minified CSS- and JavaScript-files the timestamp was generated by taking the last change time of the unminified file. https://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4122

3.5.0 (2-08-2013):

Sign T4MVCExtensions.dll http://t4mvc.codeplex.com/discussions/432534
Call T4Extension.TimestampString through delegate for unit testing http://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4040

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_History

davidebbo — Sat, 27 Apr 2013 01:41:32 GMT

T4MVC change history

3.6.0 (4-26-2013)

Add support for task based actions. https://t4mvc.codeplex.com/SourceControl/network/forks/kev_bite/T4mvcTaskBasedActions/contribution/4564

3.5.4 (4-22-2013)

Make action results internal to avoid cross project conflicts

3.5.3 (4-19-2013):

Add support for portable areas without a standard area folder

3.5.2 (3-07-2013):

Add support for inherited controller attributes. http://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/4194

3.5.1 (2-25-2013):

If static files include a timestamp, previously for minified CSS- and JavaScript-files the timestamp was generated by taking the last change time of the unminified file. https://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4122

3.5.0 (2-08-2013):

Sign T4MVCExtensions.dll http://t4mvc.codeplex.com/discussions/432534
Call T4Extension.TimestampString through delegate for unit testing http://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4040

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_History

davidebbo — Mon, 22 Apr 2013 22:13:53 GMT

T4MVC change history

3.5.4 (4-22-2013)

Make action results internal to avoid cross project conflicts

3.5.3 (4-19-2013):

Add support for portable areas without a standard area folder

3.5.2 (3-07-2013):

Add support for inherited controller attributes. http://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/4194

3.5.1 (2-25-2013):

If static files include a timestamp, previously for minified CSS- and JavaScript-files the timestamp was generated by taking the last change time of the unminified file. https://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4122

3.5.0 (2-08-2013):

Sign T4MVCExtensions.dll http://t4mvc.codeplex.com/discussions/432534
Call T4Extension.TimestampString through delegate for unit testing http://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4040

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_History

davidebbo — Fri, 19 Apr 2013 20:50:53 GMT

T4MVC change history

3.5.3 (4-19-2013):

Add support for portable areas without a standard area folder

3.5.2 (3-07-2013):

Add support for inherited controller attributes. http://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/4194

3.5.1 (2-25-2013):

If static files include a timestamp, previously for minified CSS- and JavaScript-files the timestamp was generated by taking the last change time of the unminified file. https://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4122

3.5.0 (2-08-2013):

Sign T4MVCExtensions.dll http://t4mvc.codeplex.com/discussions/432534
Call T4Extension.TimestampString through delegate for unit testing http://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4040

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_History

davidebbo — Thu, 07 Mar 2013 23:24:09 GMT

T4MVC change history

3.5.2 (3-07-2013):

Add support for inherited controller attributes. http://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/4194

3.5.1 (2-25-2013):

If static files include a timestamp, previously for minified CSS- and JavaScript-files the timestamp was generated by taking the last change time of the unminified file. https://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4122

3.5.0 (2-08-2013):

Sign T4MVCExtensions.dll http://t4mvc.codeplex.com/discussions/432534
Call T4Extension.TimestampString through delegate for unit testing http://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4040

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_History

davidebbo — Mon, 25 Feb 2013 19:18:23 GMT

T4MVC change history

3.5.1 (2-25-2013):

If static files include a timestamp, previously for minified CSS- and JavaScript-files the timestamp was generated by taking the last change time of the unminified file. https://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4122

3.5.0 (2-08-2013):

Sign T4MVCExtensions.dll http://t4mvc.codeplex.com/discussions/432534
Call T4Extension.TimestampString through delegate for unit testing http://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4040

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_Twitter

davidebbo — Mon, 11 Feb 2013 23:51:28 GMT

Here are a few awesome tweets from the T4MVC community…

“I fell in love with T4MVC.. why haven't I used it before? I fell like I missed something.” @rafek 27 Jan 2013

“Why have I never looked at T4MVC before?” @philpursglove 21 Jan 2013

“Just discovered T4MVC and started putting it to use. It's freeking phenomenal.” @ardave2002 29 Aug 2012

“Just discovered T4MVC, pretty amazing and I cannot fathom why it's not built into MVC” @backpackhasjetz 25 Jul 2012

“If your using mvc 3 or 4 please please check out T4MVC its on Nuget and is flippin awesome!” @gsuttie 25 May 2012

“How did I develop MVC apps before T4MVC?” @marcandrewb 26 Apr 2012

“Just discovered T4MVC by @davidebbo #how-did-I-live-without-this” @chrispaynter 8 Apr 2012

“@gsuttie Never mind bang for your buck, T4MVC is a sonic boom for a few cents.” @steviehailey 10 Jan 2012

“I rarely agree with code-gen anywhere, but the typed API generated by T4MVC for your projects resources is a win!” @demisbellot 6 Oct 2011

“@kevinmontrose @samsaffron We're using T4MVC on the Careers side. One thing it does is make all View paths explicit and strongly-typed.” @clipperhouse 6 Oct 2011

“Omg. T4MVC. Why hasn't this come up more often in MVC discussions? http://bit.ly/o3Wll6” @Jimmy_Byrd 19 Jul 2011

“I <3 #T4MVC!” @long2know 13 Jul 2011

“@bvrhovnik @rok_b Yeah, it does. And T4MVC has immediate benefits with almost no learning curve :)” @studiopesec 1 Jul 2011

“#MVC3 developers: NuGet @davidebbo's #T4MVC before you write another magicified string!! http://t.co/ew02GZG” @vinneyk 30 Jun 2011

Updated Wiki: T4MVC_History

davidebbo — Fri, 08 Feb 2013 23:28:58 GMT

T4MVC change history

3.5.0 (2-08-2013):

Sign T4MVCExtensions.dll http://t4mvc.codeplex.com/discussions/432534
Call T4Extension.TimestampString through delegate for unit testing http://t4mvc.codeplex.com/SourceControl/network/forks/rmarcush/t4mvc/contribution/4040

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_History

davidebbo — Fri, 01 Feb 2013 00:17:49 GMT

T4MVC change history

3.4.1 (1-31-2013):

Make T4MVCHelpers internal to avoid cross project conflicts http://t4mvc.codeplex.com/workitem/17

3.4.0 (1-23-2013):

Add optional support for async methods https://t4mvc.codeplex.com/SourceControl/network/forks/mswainatwork/t4mvc/contribution/3958
Generate partial methods to allow custom "overloading" of the return values.

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: Documentation

mswainatwork — Thu, 24 Jan 2013 13:45:19 GMT

T4MVC Documentation page

1. Introduction

T4MVC is a T4 template for ASP.NET MVC apps that creates strongly typed helpers that eliminate the use of literal strings when referring the controllers, actions and views. It helps make your MVC code much more maintainable, and gives you intellisense where you normally would not have any. It was started by David Ebbo as a little blog post thing, and has since gained many new features based on great community feedback.

T4MVC runs in both Visual Studio 2008 SP1 and Visual Studio 2010, and supports both ASP.NET MVC 1.0 and 2.0.

To use it, simply install the T4MVC package using NuGet. You will get T4MVC.tt in your project, and will instantly see a number of files get created in Visual Studio under it.

The code in those generated files enable a whole range of scenarios, all relating to replacing unwanted literal strings with a strongly typed alternative. The documentation below gives a complete list of those scenarios.

2. Scenarios

Instead of a formal documentation, we'll just demonstrate by example the various scenarios where T4MVC helps improve your code. The examples are shown in a before/after format to outline the change that is made.

Note: a lot of the examples given below are based on the Nerd Dinner sample MVC application.

2.1 Using View Name constants

Any time you would use a literal string to refer to a view, T4MVC gives you a strongly typed alternative. e.g. suppose you have this code in a view:

<% Html.RenderPartial("DinnerForm"); %>

This ugly “DinnerForm” literal string needs to go! Instead, you can now write:

<% Html.RenderPartial(MVC.Dinners.Views.DinnerForm); %>

When you need to use a view name inside a controller, things get even easier. e.g. you can replace:

return View("InvalidOwner");

return View(Views.InvalidOwner);

Note how you can omit the MVC.Dinners prefix, since this is implied by the fact that the code lives in the Dinners controller.

2.1.1 Non-Qualified View Name Constants

Non-qualified view names can be used via the ViewNames property underneath the Views property. Non-qualified views are usefull for allowing overloading and are needed by certain setups, e.g. Spark.

Traditional "Magic String" Non-Qualified view:

return View("Index");

T4MVC Non-Qualified view:

return View(Views.ViewNames.Index);

2.2 Referring to controller actions

Many MVC APIs follow a pattern where you need to pass three pieces of information in order to refer to a controller action:

the controller name (often implied when dealing with the current controller)
the action method name
the parameters to be passed to the action method

All of this is typically done by passing literal strings for #1 and #2, and an anonymous object for #3, e.g.

<%= Html.ActionLink("Delete Dinner", "Delete", "Dinners", new { id = Model.DinnerID }, null)%>

Here, "Delete" and "Dinners" are clear literal strings that we'd like to get rid of. But that's not all, as the paramter name 'id' is as much of a problem as those other two. Even though it doesn’t look like a literal string, it very much is one in disguise. Don’t let those anonymous objects fool you!

With T4MVC, you would instead write:

<%= Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID))%>

Basically, we got rid of the three unwanted literal strings (“Delete”, "Dinners" and “Id”), and replaced them by a very natural looking method call to the controller action. Of course, this is not really calling the controller action, which would be very wrong here. But it’s capturing the essence of method call, and turning it into the right route values.

One other great benefit of this approach is that you get full intellisense while you type this line. In fact, you even get full refactoring support if you use a tool like resharper which supports aspx refactoring!

Adding additional route parameters

In some situation, you may need to add extra values to the route that don’t exist in the action method. You can do it as follows:

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID)
    .AddRouteValue("foo", 17))

You can add multiple values this way using a fluent approach, e.g.

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID)
    .AddRouteValue("foo", 17)
    .AddRouteValue("bar", "abc"))

As an alternative for adding multiple values, you can write:

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID)
    .AddRouteValues(new { foo = 17, bar = "abc"}))

Note that in some cases, you may want to omit the action method parameters from the route, possibly because they are meant to come from form data and not from the URL. For those cases, you can always use the parameter-less override that T4MVC generates (that part is not new), e.g.

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete()
    .AddRouteValues(new { foo = 17, bar = "abc"}))

Now suppose you want to add all the current query string values to the route values produced by T4MVC. You can use the AddRouteValues() overload that takes a NameValueCollection. e.g.

RedirectToAction(MVC.Home.MyAction().AddRouteValues(Request.QueryString));

This adds to the existing set of AddRouteValue/AddRouteValues fluent APIs to make it easier to deal with all kind different situations.

The nice thing about this fluent approach is that it doesn’t require adding overloads to all the T4MVC helpers (e.g. Html.ActionLink is this case) to take in the extra route values. Instead, it automatically applies to any method that uses the T4MVC pattern.

The general pattern of making a pseudo-call to a controller action is used is many places in T4MVC:

2.2.1 Html.ActionLink

Ok, we just covered that one above.

2.2.2 Url.Action

<%= Url.Action("Delete", "Dinners", new { id = Model.DinnerID })%>

becomeshttp://mvccontrib.codeplex.com/wikipage?action=Edit&title=T4MVC_doc&version=2&referringTitle=T4MVC

<%= Url.Action(MVC.Dinners.Delete(Model.DinnerID))%>

2.2.2a Url.JavaScriptReplacableUrl

Two use cases for the above.

1st Use Case:
If you have an action you want to call from javascript like this:

<%= Url.Action(MVC.Dinners.Display(Model.DinnerID))%>

Odds are you want to get the Model.DinnerID from a javascript variable. So you end up with

var myUrl=<%= Url.Action(MVC.Dinners.Display())%>
//myUrl will be  /Dinners/Display
var myFinalUrl=myUrl+"/"+dinnerId;   ///Dinners/Display/12
//or does it look like 
var myFinalUrl=myUrl+"?dinnerID"+dinnerId;  ///Dinners/Display?dinnerId=12

The issue is you are not sure how to compose the URL and if it changes, this will silently break.

2nd Use Case:
For the above action in your routing table you created a route like:
"Dinners/Display/{dinnerId}" - and you constrain dinnerId to be an integer larger than zero.

Now, if you do the same scenario above:

var myUrl=<%= Url.Action(MVC.Dinners.Display())%>

The route will not be found - because there is not a route match (since dinnerId was not provided).

JavaScriptReplacableUrl solves both of these issues
No matter which use case, you define a specific route for the action (constrained parameters or not)
In the routing table you add:
"Dinners/Display/{dinnerId}" - (constrain dinnerId if you want)
Note: You must define a specific route for JavaScriptReplacableUrl to work like this - it cannot work with 'default routes'. If it cannot find a matching route it behaves like Url.Action().

var myUrl=<%= Url.JavaScriptReplacableUrl(MVC.Dinners.Display())%>
//myUrl will be Dinners/Display/{dinnerId} 
var myFinalUrl=myUrl.replace("{dinnerId}", dinnerId);   //this will have whatever route shape you defined in routing table!

Note you can use the parameter name constants from T4MVC (and that will give you compile time checking for parameter name changes:

var myFinalUrl=myUrl.replace("{"+MVC.Dinners.DisplayParams.dinnerId+"}", dinnerId);   //this will have whatever route shape you defined

2.2.3 Ajax.ActionLink

<%= Ajax.ActionLink( "RSVP for this event",
                     "Register", "RSVP",
                     new { id=Model.DinnerID }, 
                     new AjaxOptions { UpdateTargetId="rsvpmsg", OnSuccess="AnimateRSVPMessage" }) %>

becomes

<%= Ajax.ActionLink( "RSVP for this event",
                     MVC.RSVP.Register(Model.DinnerID),
                     new AjaxOptions { UpdateTargetId="rsvpmsg", OnSuccess="AnimateRSVPMessage" }) %>

2.2.4 RedirectToAction (in controller code)

return RedirectToAction("Details", new { id = dinner.DinnerID });

becomes

return RedirectToAction(MVC.Dinners.Details(dinner.DinnerID));

2.2.5 routes.MapRoute (typically in global.asax)

routes.MapRoute(
    "UpcomingDinners", 
    "Dinners/Page/{page}", 
    new { controller = "Dinners", action = "Index" }
);

becomes

routes.MapRoute(
    "UpcomingDinners", 
    "Dinners/Page/{page}", 
    MVC.Dinners.Index(null)
);

2.2.6 Html.BeginForm

Essentially, it’s the same support as ActionLink() but for the BeginForm() method. But note that because form posts typically pass most of the data via the form and not the URL, BeginForm() is trickier to use correctly than the other methods.

Here is how you might use this:

using (Html.BeginForm(MVC.Account.LogOn(), FormMethod.Post)) { ... }

Or if the action method takes parameters, you would pass them in the call. However, when you do this you need to make sure that you aren’t also trying to pass those same parameters via the form (e.g. using a text box).

Generally, the rule of thumb is that this support works well when you’re dealing with forms where the Action method signature exactly matches the form URL.

2.2.7 Html.RenderAction and Html.Action (only in MVC 2 or newer)

These are new to MVC 2. See Phil Haack's post about them for details.

<%= Html.Action("Menu", new { options = new MenuOptions { Width=400, Height=500} })%>

becomes

<%= Html.Action(MVC.Home.Menu(new MenuOptions { Width=400, Height=500})); %>

Same deal for Html.RenderAction.

2.3. Use constants to refer to area, controller, action and parameter names

2.3.1 Area name constants

MVC.CoolArea.Name

2.3.2 Controller name constants

MVC.Home.Name

2.3.3 Action name constants

MVC.Home.ActionNames.Index

2.3.4 Parameter name constants

Assuming a Home.MyAction action that takes a foo parameter, this evaluates to "foo":

MVC.Home.MyActionParams.foo

2.4. Strongly typed links to script files and static resources

T4MVC generates static helpers for your content files and script files. So instead of writing:

<img src="/Content/nerd.jpg" />

You can write:

<img src="<%= Links.Content.nerd_jpg %>" />

Likewise, instead of

<script src="/Scripts/Map.js" type="text/javascript"></script>

You can write

<script src="<%= Links.Scripts.Map_js %>" type="text/javascript"></script>

The obvious benefit is that you’ll get a compile error if you ever move or rename your static resource, so you’ll catch it earlier.

Another benefit is that you get a more versatile reference. When you write src="/Content/nerd.jpg", your app will only work when it’s deployed at the root of the site. But when you use the helper, it executes some server side logic that makes sure your reference is correct wherever your site is rooted. It does this by calling VirtualPathUtility.ToAbsolute("~/Content/nerd.jpg").

One unfortunate thing is that for some reason, VS doesn’t support intellisense in the view for parameter values. As a workaround, you can type it outside of the tag to get intellisense and then copy it there.

Important note: if you see strange links getting generated in your <head> tag, you just need to remove the runat="server" from it.

Support for MVC's script and style bundles

Starting from MVC4, one can define "bundles" of scripts and stylesheets which are automatically combined and minified. However, magic strings are used to define the resource URLs. To eliminate them, follow steps 1 to 3 below.

1. Add the following to your own code, which will extend T4MVC's static partial "Links.bundles.scripts" and "Links.bundles.styles" classes:

  namespace Links {
    public static partial class bundles {
      public static partial class scripts {
        public static readonly string jquery = "~/scripts/jquery";
        public static readonly string jqueryui = "~/scripts/jqueryui";
      }
      public static partial class styles {
        public static readonly string bootstrap = "~/styles/boostrap";
        public static readonly string theme = "~/styles/theme";
        public static readonly string common = "~/styles/common";
      }
    }
  }

Notice how the magic strings are now defined in one place only, and are thus easy to maintain.

2. Use the following to add your bundles to the runtime:

  bundles.Add(new ScriptBundle(Links.bundles.scripts.jquery).Include("~/scripts/jquery-{version}.js"));
  bundles.Add(new StyleBundle(Links.bundles.styles.bootstrap).Include("~/styles/bootstrap*.css"));

3. Use the following to use a bundle in a cshtml layout/view:

  @Scripts.Render(Links.bundles.scripts.jquery)
  @Styles.Render(Links.bundles.scripts.bootstrap)

Support for Minified Javascript files

Minified javascript files are alternate version of the files that makes them as small as possible, but using various strategies like removing white space. e.g. in an MVC application’s Scripts folder, you’ll typically see both jquery-1.3.2.js and jquery-1.3.2.min.js. Usually, you want to use the minified version at deployment time (to make your site load faster), but the regular version at development time, so you can more easily debug into it.

T4MVC makes it automatic to use one vs. the other depending on the context. e.g. suppose you have:

<script src="<%= Links.Scripts.jquery_1_2_6_js %>" type="text/javascript"></script>

You don’t need to change anything to this line, but the token jquery_1_2_6_js will automatically point to either jquery-1.3.2.js or jquery-1.3.2.min.js depending on whether you’re running in production. How does it know whether you’re in production? It calls a method defined in T4MVC.tt.hooks.t4 which makes the decision. By default, it looks at whether debugging is enabled:

// Logic to determine if the app is running in production or dev environment
public static bool IsProduction() { 
    return (HttpContext.Current != null && !HttpContext.Current.IsDebuggingEnabled); 
}

But you can easily change this logic if you have a different way of determining ‘production’.

2.5 Using T4MVC with "Areas"

One of MVC 2's major new features is the support for breaking up a large application into "Areas". This works by following a structure that looks like:

Root folder
- Areas
  - NerdDinner
    - Models
    - Views
    - Controllers
  - Wiki
    - Models
    - Views
    - Controllers

T4MVC automatically works with your areas and makes them available in its object model. Here is an example:

<%= Html.ActionLink("Delete Dinner", MVC.NerdDinner.Dinners.Delete(Model.DinnerID))%>

Notice how we refered to the controller as MVC.NerdDinner.Dinners. Note that if you happen to have a top level controller with the same name as the area, this naming pattern would cause a conflict. In that case, T4MVC appends 'Area' at the end of the area name to avoid the conflict. e.g. If you have both a Home area and a Home controller (top level), you would use MVC.HomeArea.Hello to refer to the area.

Optionally, if you set IncludeAreasToken to true in the settings.xml file, the naming scheme becomes:

<%= Html.ActionLink("Delete Dinner", MVC.Areas.NerdDinner.Dinners.Delete(Model.DinnerID))%>

Note that in this case, the conflict situation discussed above cannot occur. But this comes with a price as you end up with one more segment all the time. I'm debating whether to even keep this mode given that the default mode works quite well.

2.6 Using T4MVC with AsyncController

2.6.1 Enable Asynchronous Action Support

To enable support for using asynchronous actions in T4MVC you first need to change the SupportAsyncActions setting to true. This is setting is false by default since Async action calls are handled a little differently than normal action calls.

2.6.1 What it does

When enabled any AsyncController with an Async action will have two new methods generated in it. The first method is the standard Parameterless Overload and the second one one with the same signature as the Async method but with out the Async extension. In addition, this method returns the standard ActionResult regarless of the possible return types of the *Completed methods.

For example the following action in your controller

public void IndexAsync(long id) 
{
   ...
}

public JsonResult IndexCompleted(Models.SomeModel model)
{
   return this.JSON(model);
}

would cause the following code to be generated by T4MVC

public virtual ActionResult Index() 
{
   ...
}

public virtual ActionResult Index(long id)
{
   ...
}

With this additional code you can use MVC.Controller.Action() to generate links, regardless if the action
is Async or not, however, you cannot mix and match with the same method names, all must be either Async or not.

3. Tweaking the behavior of T4MVC

When you download T4MVC, you not only get the main T4MVC.tt template, but you also get a file named T4MVC.tt.hooks.t4, which can conatin some extensibility hooks. In addition to that, T4MVC supports a T4MVC.tt.settings.xml. This file will be created with some defaults the first time T4MVC gets to run. This file contains various knobs that you can use to tweak the code generated by T4MVC. This section describes the various switches:

3.1 Using Model 'unbinders'

By default T4MVC basically performs a .ToString() operation when adding objects to URLs (route values). It works great for value types and strings, but usually fails at complex objects. Model unbinders let you inject your custom logic into the process of serializing model to URL parameters. Say, you have the following action:

public ActionResult Profile(User user) {}
public class User {
  public int Id { get; set; }
  public string Login { get; set; }
}

Here's the typical result of generating an URL for that action with T4MVC:

@Url.Action(MVC.Home.Profile(new User {Id = 1})); // -> /Home/Profile?user=Mvc.HomeController.User

If you'd like to get an URL like /Home/Profile?user=1 you could write a model unbinder, which should implement either IModelUnbinder or IModelUnbinder<T>:

public class UserUnbinder : IModelUnbinder<User>
{
    public void UnbindModel(RouteValueDictionary routeValueDictionary, string routeName, User user)
    {
        if (user != null)
            routeValueDictionary.Add(routeName, user.Id);
    }
}

and then inject it to T4MVC in Application_Start:

ModelUnbinderHelpers.ModelUnbinders.Add(new UserUnbinder());

After that you'll get exactly what described above:

@Url.Action(MVC.Home.Profile(new User {Id = 1})); // -> /Home/Profile?user=1

If you want T4MVC to serialize all the properties of the certain type to url parameters, built-in PropertiesUnbinder could help you do this:

ModelUnbinderHelpers.ModelUnbinders.Add(typeof(User), new PropertiesUnbinder());

In this case you'll get:

@Url.Action(MVC.Home.Profile(new User {Id = 1, Login = "test" })); // -> /Home/Profile?user.Id=1&user.Login=test

which will gently suit the default MVC model binder. T4MVC searches for unbinders through the base types and interfaces that the object implements.

3.2 XML Settings File

The T4MVC.tt.settings.t4 file have been replaced with a more "upgrade friendly" XML configuration file. This file is automatically generated/updated by the template when it is run, so the file will always reflect the current options and settings for the template. This new structure means that future upgrade to the template will not cause manual merging of your settings into a new settings, or for the template to break because a new setting was added. Your modified existing T4MVC.tt.settings.t4 will be left behind after upgrade and will not longer be used, however, the template cannot import your settings so you will have to edit the new XML file and copy them over. Once done you can safely delete the settings.t4 file.

Two methods from the old settings file were moved into a new T4MVC.tt.hooks.t4 file, AddTimestampToStaticLink and RenderAdditionalCode. Neither of these tweaks could be properly represented in an XML file since they are adjustments to the template its self. Changes to this file should be rare and documented when done, so during upgrades you can generally ignore replacement errors if you have customized its contents.

3.3 Miscellaneous tweaks

Set SplitIntoMultipleFiles to false to generate a single file with everything

<!-- If true,the template output will be split into multiple files. -->
<SplitIntoMultipleFiles>true</SplitIntoMultipleFiles>

Use HelpersPrefix to change the MVC prefix of the generated classes

<!-- The prefix used for things like MVC.Dinners.Name and MVC.Dinners.Delete(Model.DinnerID) -->
<HelpersPrefix>MVC</HelpersPrefix>

Use ControllersFolder and ViewsRootFolder to rename the Controllers and Views folders

<!-- The folder under the project that contains the controllers -->
<ControllersFolder>Controllers</ControllersFolder>

<!-- The folder under the project that contains the views -->
<ViewsRootFolder>Views</ViewsRootFolder>

Use LinksNamespace the generated links' namespace

<!-- The namespace that the links are generated in (e.g. "Links", as in Links.Content.nerd_jpg) -->
<LinksNamespace>Links</LinksNamespace>

Use StaticFilesFolders to tweak the list of folders from which links are generated

<!-- Folders containing static files for which links are generated (e.g. Links.Scripts.Map_js) -->
<StaticFilesFolders>
    <FileFolder>Scripts</FileFolder>
    <FileFolder>Content</FileFolder>
</StaticFilesFolders>

Use GenerateParamsAsConstantsForActionMethods to generate constants instead of static classes for parameter names. This lets you use them in attributes.

  <!--The true the parameter name class will be generated as constants (allowing use in attributes).  This is the suggested way to do this.  However, if you used T4MVC Params before and referenced them outside the controller, your references will need to change from MVC.User.MyActionParams   to MVC.UserController.MyActionParams.  -->  <GenerateParamsAsConstantsForActionMethods>True</GenerateParamsAsConstantsForActionMethods>

Customize Action values

The generated T4MVC_ControllerClass classes are now partial classes so you can extend and customize the values returned from MVC.Controller.Action() calls. In this class, for each overridden method a partial method call is available, if you implement that partial you have the ability to modify the the action values before they are returned.

partial T4MVC_SomeController
{
    partial void SomeAction(T4MVC_System_Web_Mvc_ActionResult callInfo)
    {
        callInfo.RouteValues["other"] = 1;
    }
}

Also, the parameterless methods are not virtual so they can be overridden in the partial as well.

partial T4MVC_SomeController
{
    public override ActionResult SomeAction()
    {
        var callInfo = base.SomeAction();
        callInfo.GetRouteValueDictionary()["other"] = 1;
        return callInfo;
    }
}

4. Related resources

David Ebbo has written a series of blog posts on T4MVC
Scott Hanselman also blogged about it here

Updated Wiki: T4MVC_History

davidebbo — Wed, 16 Jan 2013 19:02:27 GMT

T4MVC change history

3.3.0 (1-16-2013):

Add support for support for model unbinder providers https://t4mvc.codeplex.com/SourceControl/network/forks/Augi/T4MVCUnbinderProvider/contribution/3879
Fix handling of "completed" methods https://t4mvc.codeplex.com/SourceControl/network/forks/phw/t4mvc/contribution/3922

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

New Comment on "Documentation"

schalkvanwyk — Tue, 08 Jan 2013 13:38:57 GMT

Don't forget to use Chirpy and set the T4 options: http://blog.waynebrantley.com/2010/07/t4mvc-add-in-and-resource-compression.html

Updated Wiki: T4MVC_History

davidebbo — Fri, 28 Dec 2012 06:45:00 GMT

T4MVC change history

3.2.1 (12-27-2012):

Fix issue with VB projects causing exceptions http://t4mvc.codeplex.com/workitem/7

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: Documentation

WayneBrantley — Wed, 12 Dec 2012 06:57:49 GMT

T4MVC Documentation page

1. Introduction

2. Scenarios

2.1 Using View Name constants

Any time you would use a literal string to refer to a view, T4MVC gives you a strongly typed alternative. e.g. suppose you have this code in a view:

<% Html.RenderPartial("DinnerForm"); %>

This ugly “DinnerForm” literal string needs to go! Instead, you can now write:

<% Html.RenderPartial(MVC.Dinners.Views.DinnerForm); %>

When you need to use a view name inside a controller, things get even easier. e.g. you can replace:

return View("InvalidOwner");

return View(Views.InvalidOwner);

Note how you can omit the MVC.Dinners prefix, since this is implied by the fact that the code lives in the Dinners controller.

2.1.1 Non-Qualified View Name Constants

return View("Index");

T4MVC Non-Qualified view:

return View(Views.ViewNames.Index);

2.2 Referring to controller actions

Many MVC APIs follow a pattern where you need to pass three pieces of information in order to refer to a controller action:

the controller name (often implied when dealing with the current controller)
the action method name
the parameters to be passed to the action method

All of this is typically done by passing literal strings for #1 and #2, and an anonymous object for #3, e.g.

<%= Html.ActionLink("Delete Dinner", "Delete", "Dinners", new { id = Model.DinnerID }, null)%>

<%= Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID))%>

Adding additional route parameters

In some situation, you may need to add extra values to the route that don’t exist in the action method. You can do it as follows:

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID)
    .AddRouteValue("foo", 17))

You can add multiple values this way using a fluent approach, e.g.

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID)
    .AddRouteValue("foo", 17)
    .AddRouteValue("bar", "abc"))

As an alternative for adding multiple values, you can write:

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID)
    .AddRouteValues(new { foo = 17, bar = "abc"}))

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete()
    .AddRouteValues(new { foo = 17, bar = "abc"}))

Now suppose you want to add all the current query string values to the route values produced by T4MVC. You can use the AddRouteValues() overload that takes a NameValueCollection. e.g.

RedirectToAction(MVC.Home.MyAction().AddRouteValues(Request.QueryString));

2.2.1 Html.ActionLink

Ok, we just covered that one above.

2.2.2 Url.Action

<%= Url.Action("Delete", "Dinners", new { id = Model.DinnerID })%>

becomeshttp://mvccontrib.codeplex.com/wikipage?action=Edit&title=T4MVC_doc&version=2&referringTitle=T4MVC

<%= Url.Action(MVC.Dinners.Delete(Model.DinnerID))%>

2.2.2a Url.JavaScriptReplacableUrl

Two use cases for the above.

1st Use Case:
If you have an action you want to call from javascript like this:

<%= Url.Action(MVC.Dinners.Display(Model.DinnerID))%>

Odds are you want to get the Model.DinnerID from a javascript variable. So you end up with

var myUrl=<%= Url.Action(MVC.Dinners.Display())%>
//myUrl will be  /Dinners/Display
var myFinalUrl=myUrl+"/"+dinnerId;   ///Dinners/Display/12
//or does it look like 
var myFinalUrl=myUrl+"?dinnerID"+dinnerId;  ///Dinners/Display?dinnerId=12

var myUrl=<%= Url.Action(MVC.Dinners.Display())%>

var myUrl=<%= Url.JavaScriptReplacableUrl(MVC.Dinners.Display())%>
//myUrl will be Dinners/Display/{dinnerId} 
var myFinalUrl=myUrl.replace("{dinnerId}", dinnerId);   //this will have whatever route shape you defined in routing table!

Note you can use the parameter name constants from T4MVC (and that will give you compile time checking for parameter name changes:

var myFinalUrl=myUrl.replace("{"+MVC.Dinners.DisplayParams.dinnerId+"}", dinnerId);   //this will have whatever route shape you defined

2.2.3 Ajax.ActionLink

<%= Ajax.ActionLink( "RSVP for this event",
                     "Register", "RSVP",
                     new { id=Model.DinnerID }, 
                     new AjaxOptions { UpdateTargetId="rsvpmsg", OnSuccess="AnimateRSVPMessage" }) %>

becomes

<%= Ajax.ActionLink( "RSVP for this event",
                     MVC.RSVP.Register(Model.DinnerID),
                     new AjaxOptions { UpdateTargetId="rsvpmsg", OnSuccess="AnimateRSVPMessage" }) %>

2.2.4 RedirectToAction (in controller code)

return RedirectToAction("Details", new { id = dinner.DinnerID });

becomes

return RedirectToAction(MVC.Dinners.Details(dinner.DinnerID));

2.2.5 routes.MapRoute (typically in global.asax)

routes.MapRoute(
    "UpcomingDinners", 
    "Dinners/Page/{page}", 
    new { controller = "Dinners", action = "Index" }
);

becomes

routes.MapRoute(
    "UpcomingDinners", 
    "Dinners/Page/{page}", 
    MVC.Dinners.Index(null)
);

2.2.6 Html.BeginForm

using (Html.BeginForm(MVC.Account.LogOn(), FormMethod.Post)) { ... }

2.2.7 Html.RenderAction and Html.Action (only in MVC 2 or newer)

These are new to MVC 2. See Phil Haack's post about them for details.

<%= Html.Action("Menu", new { options = new MenuOptions { Width=400, Height=500} })%>

becomes

<%= Html.Action(MVC.Home.Menu(new MenuOptions { Width=400, Height=500})); %>

Same deal for Html.RenderAction.

2.3. Use constants to refer to area, controller, action and parameter names

2.3.1 Area name constants

MVC.CoolArea.Name

2.3.2 Controller name constants

MVC.Home.Name

2.3.3 Action name constants

MVC.Home.ActionNames.Index

2.3.4 Parameter name constants

Assuming a Home.MyAction action that takes a foo parameter, this evaluates to "foo":

MVC.Home.MyActionParams.foo

2.4. Strongly typed links to script files and static resources

T4MVC generates static helpers for your content files and script files. So instead of writing:

<img src="/Content/nerd.jpg" />

You can write:

<img src="<%= Links.Content.nerd_jpg %>" />

Likewise, instead of

<script src="/Scripts/Map.js" type="text/javascript"></script>

You can write

<script src="<%= Links.Scripts.Map_js %>" type="text/javascript"></script>

Support for MVC's script and style bundles

  namespace Links {
    public static partial class bundles {
      public static partial class scripts {
        public static readonly string jquery = "~/scripts/jquery";
        public static readonly string jqueryui = "~/scripts/jqueryui";
      }
      public static partial class styles {
        public static readonly string bootstrap = "~/styles/boostrap";
        public static readonly string theme = "~/styles/theme";
        public static readonly string common = "~/styles/common";
      }
    }
  }

Notice how the magic strings are now defined in one place only, and are thus easy to maintain.

2. Use the following to add your bundles to the runtime:

  bundles.Add(new ScriptBundle(Links.bundles.scripts.jquery).Include("~/scripts/jquery-{version}.js"));
  bundles.Add(new StyleBundle(Links.bundles.styles.bootstrap).Include("~/styles/bootstrap*.css"));

3. Use the following to use a bundle in a cshtml layout/view:

  @Scripts.Render(Links.bundles.scripts.jquery)
  @Styles.Render(Links.bundles.scripts.bootstrap)

Support for Minified Javascript files

<script src="<%= Links.Scripts.jquery_1_2_6_js %>" type="text/javascript"></script>

// Logic to determine if the app is running in production or dev environment
public static bool IsProduction() { 
    return (HttpContext.Current != null && !HttpContext.Current.IsDebuggingEnabled); 
}

But you can easily change this logic if you have a different way of determining ‘production’.

2.5 Using T4MVC with "Areas"

One of MVC 2's major new features is the support for breaking up a large application into "Areas". This works by following a structure that looks like:

Root folder
- Areas
  - NerdDinner
    - Models
    - Views
    - Controllers
  - Wiki
    - Models
    - Views
    - Controllers

T4MVC automatically works with your areas and makes them available in its object model. Here is an example:

<%= Html.ActionLink("Delete Dinner", MVC.NerdDinner.Dinners.Delete(Model.DinnerID))%>

<%= Html.ActionLink("Delete Dinner", MVC.Areas.NerdDinner.Dinners.Delete(Model.DinnerID))%>

3. Tweaking the behavior of T4MVC

3.1 Using Model 'unbinders'

public ActionResult Profile(User user) {}
public class User {
  public int Id { get; set; }
  public string Login { get; set; }
}

Here's the typical result of generating an URL for that action with T4MVC:

@Url.Action(MVC.Home.Profile(new User {Id = 1})); // -> /Home/Profile?user=Mvc.HomeController.User

If you'd like to get an URL like /Home/Profile?user=1 you could write a model unbinder, which should implement either IModelUnbinder or IModelUnbinder<T>:

public class UserUnbinder : IModelUnbinder<User>
{
    public void UnbindModel(RouteValueDictionary routeValueDictionary, string routeName, User user)
    {
        if (user != null)
            routeValueDictionary.Add(routeName, user.Id);
    }
}

and then inject it to T4MVC in Application_Start:

ModelUnbinderHelpers.ModelUnbinders.Add(new UserUnbinder());

After that you'll get exactly what described above:

@Url.Action(MVC.Home.Profile(new User {Id = 1})); // -> /Home/Profile?user=1

If you want T4MVC to serialize all the properties of the certain type to url parameters, built-in PropertiesUnbinder could help you do this:

ModelUnbinderHelpers.ModelUnbinders.Add(typeof(User), new PropertiesUnbinder());

In this case you'll get:

@Url.Action(MVC.Home.Profile(new User {Id = 1, Login = "test" })); // -> /Home/Profile?user.Id=1&user.Login=test

which will gently suit the default MVC model binder. T4MVC searches for unbinders through the base types and interfaces that the object implements.

3.2 XML Settings File

3.3 Miscellaneous tweaks

Set SplitIntoMultipleFiles to false to generate a single file with everything

<!-- If true,the template output will be split into multiple files. -->
<SplitIntoMultipleFiles>true</SplitIntoMultipleFiles>

Use HelpersPrefix to change the MVC prefix of the generated classes

<!-- The prefix used for things like MVC.Dinners.Name and MVC.Dinners.Delete(Model.DinnerID) -->
<HelpersPrefix>MVC</HelpersPrefix>

Use ControllersFolder and ViewsRootFolder to rename the Controllers and Views folders

<!-- The folder under the project that contains the controllers -->
<ControllersFolder>Controllers</ControllersFolder>

<!-- The folder under the project that contains the views -->
<ViewsRootFolder>Views</ViewsRootFolder>

Use LinksNamespace the generated links' namespace

<!-- The namespace that the links are generated in (e.g. "Links", as in Links.Content.nerd_jpg) -->
<LinksNamespace>Links</LinksNamespace>

Use StaticFilesFolders to tweak the list of folders from which links are generated

<!-- Folders containing static files for which links are generated (e.g. Links.Scripts.Map_js) -->
<StaticFilesFolders>
    <FileFolder>Scripts</FileFolder>
    <FileFolder>Content</FileFolder>
</StaticFilesFolders>

Use GenerateParamsAsConstantsForActionMethods to generate constants instead of static classes for parameter names. This lets you use them in attributes.

  <!--The true the parameter name class will be generated as constants (allowing use in attributes).  This is the suggested way to do this.  However, if you used T4MVC Params before and referenced them outside the controller, your references will need to change from MVC.User.MyActionParams   to MVC.UserController.MyActionParams.  -->  <GenerateParamsAsConstantsForActionMethods>True</GenerateParamsAsConstantsForActionMethods>

4. Related resources

David Ebbo has written a series of blog posts on T4MVC
Scott Hanselman also blogged about it here

Updated Wiki: T4MVC_History

davidebbo — Tue, 11 Dec 2012 19:10:04 GMT

T4MVC change history

3.2.0 (12-11-2012):

Add option to make parameter names constants https://t4mvc.codeplex.com/SourceControl/network/forks/WayneBrantley/ParameterNamesToConst/contribution/3762

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: Documentation

WayneBrantley — Sun, 09 Dec 2012 20:52:58 GMT

T4MVC Documentation page

1. Introduction

2. Scenarios

2.1 Using View Name constants

Any time you would use a literal string to refer to a view, T4MVC gives you a strongly typed alternative. e.g. suppose you have this code in a view:

<% Html.RenderPartial("DinnerForm"); %>

This ugly “DinnerForm” literal string needs to go! Instead, you can now write:

<% Html.RenderPartial(MVC.Dinners.Views.DinnerForm); %>

When you need to use a view name inside a controller, things get even easier. e.g. you can replace:

return View("InvalidOwner");

return View(Views.InvalidOwner);

Note how you can omit the MVC.Dinners prefix, since this is implied by the fact that the code lives in the Dinners controller.

2.1.1 Non-Qualified View Name Constants

return View("Index");

T4MVC Non-Qualified view:

return View(Views.ViewNames.Index);

2.2 Referring to controller actions

Many MVC APIs follow a pattern where you need to pass three pieces of information in order to refer to a controller action:

the controller name (often implied when dealing with the current controller)
the action method name
the parameters to be passed to the action method

All of this is typically done by passing literal strings for #1 and #2, and an anonymous object for #3, e.g.

<%= Html.ActionLink("Delete Dinner", "Delete", "Dinners", new { id = Model.DinnerID }, null)%>

<%= Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID))%>

Adding additional route parameters

In some situation, you may need to add extra values to the route that don’t exist in the action method. You can do it as follows:

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID)
    .AddRouteValue("foo", 17))

You can add multiple values this way using a fluent approach, e.g.

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID)
    .AddRouteValue("foo", 17)
    .AddRouteValue("bar", "abc"))

As an alternative for adding multiple values, you can write:

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete(Model.DinnerID)
    .AddRouteValues(new { foo = 17, bar = "abc"}))

Html.ActionLink("Delete Dinner", MVC.Dinners.Delete()
    .AddRouteValues(new { foo = 17, bar = "abc"}))

Now suppose you want to add all the current query string values to the route values produced by T4MVC. You can use the AddRouteValues() overload that takes a NameValueCollection. e.g.

RedirectToAction(MVC.Home.MyAction().AddRouteValues(Request.QueryString));

2.2.1 Html.ActionLink

Ok, we just covered that one above.

2.2.2 Url.Action

<%= Url.Action("Delete", "Dinners", new { id = Model.DinnerID })%>

becomeshttp://mvccontrib.codeplex.com/wikipage?action=Edit&title=T4MVC_doc&version=2&referringTitle=T4MVC

<%= Url.Action(MVC.Dinners.Delete(Model.DinnerID))%>

2.2.2a Url.JavaScriptReplacableUrl

Two use cases for the above.

1st Use Case:
If you have an action you want to call from javascript like this:

<%= Url.Action(MVC.Dinners.Display(Model.DinnerID))%>

Odds are you want to get the Model.DinnerID from a javascript variable. So you end up with

var myUrl=<%= Url.Action(MVC.Dinners.Display())%>
//myUrl will be  /Dinners/Display
var myFinalUrl=myUrl+"/"+dinnerId;   ///Dinners/Display/12
//or does it look like 
var myFinalUrl=myUrl+"?dinnerID"+dinnerId;  ///Dinners/Display?dinnerId=12

var myUrl=<%= Url.Action(MVC.Dinners.Display())%>

var myUrl=<%= Url.JavaScriptReplacableUrl(MVC.Dinners.Display())%>
//myUrl will be Dinners/Display/{dinnerId} 
var myFinalUrl=myUrl.replace("{dinnerId}", dinnerId);   //this will have whatever route shape you defined in routing table!

Note you can use the parameter name constants from T4MVC (and that will give you compile time checking for parameter name changes:

var myFinalUrl=myUrl.replace("{"+MVC.Dinners.DisplayParams.dinnerId+"}", dinnerId);   //this will have whatever route shape you defined

2.2.3 Ajax.ActionLink

<%= Ajax.ActionLink( "RSVP for this event",
                     "Register", "RSVP",
                     new { id=Model.DinnerID }, 
                     new AjaxOptions { UpdateTargetId="rsvpmsg", OnSuccess="AnimateRSVPMessage" }) %>

becomes

<%= Ajax.ActionLink( "RSVP for this event",
                     MVC.RSVP.Register(Model.DinnerID),
                     new AjaxOptions { UpdateTargetId="rsvpmsg", OnSuccess="AnimateRSVPMessage" }) %>

2.2.4 RedirectToAction (in controller code)

return RedirectToAction("Details", new { id = dinner.DinnerID });

becomes

return RedirectToAction(MVC.Dinners.Details(dinner.DinnerID));

2.2.5 routes.MapRoute (typically in global.asax)

routes.MapRoute(
    "UpcomingDinners", 
    "Dinners/Page/{page}", 
    new { controller = "Dinners", action = "Index" }
);

becomes

routes.MapRoute(
    "UpcomingDinners", 
    "Dinners/Page/{page}", 
    MVC.Dinners.Index(null)
);

2.2.6 Html.BeginForm

using (Html.BeginForm(MVC.Account.LogOn(), FormMethod.Post)) { ... }

2.2.7 Html.RenderAction and Html.Action (only in MVC 2 or newer)

These are new to MVC 2. See Phil Haack's post about them for details.

<%= Html.Action("Menu", new { options = new MenuOptions { Width=400, Height=500} })%>

becomes

<%= Html.Action(MVC.Home.Menu(new MenuOptions { Width=400, Height=500})); %>

Same deal for Html.RenderAction.

2.3. Use constants to refer to area, controller, action and parameter names

2.3.1 Area name constants

MVC.CoolArea.Name

2.3.2 Controller name constants

MVC.Home.Name

2.3.3 Action name constants

MVC.Home.ActionNames.Index

2.3.4 Parameter name constants

Assuming a Home.MyAction action that takes a foo parameter, this evaluates to "foo":

MVC.Home.MyActionParams.foo

2.4. Strongly typed links to script files and static resources

T4MVC generates static helpers for your content files and script files. So instead of writing:

<img src="/Content/nerd.jpg" />

You can write:

<img src="<%= Links.Content.nerd_jpg %>" />

Likewise, instead of

<script src="/Scripts/Map.js" type="text/javascript"></script>

You can write

<script src="<%= Links.Scripts.Map_js %>" type="text/javascript"></script>

Support for MVC's script and style bundles

  namespace Links {
    public static partial class bundles {
      public static partial class scripts {
        public static readonly string jquery = "~/scripts/jquery";
        public static readonly string jqueryui = "~/scripts/jqueryui";
      }
      public static partial class styles {
        public static readonly string bootstrap = "~/styles/boostrap";
        public static readonly string theme = "~/styles/theme";
        public static readonly string common = "~/styles/common";
      }
    }
  }

Notice how the magic strings are now defined in one place only, and are thus easy to maintain.

2. Use the following to add your bundles to the runtime:

  bundles.Add(new ScriptBundle(Links.bundles.scripts.jquery).Include("~/scripts/jquery-{version}.js"));
  bundles.Add(new StyleBundle(Links.bundles.styles.bootstrap).Include("~/styles/bootstrap*.css"));

3. Use the following to use a bundle in a cshtml layout/view:

  @Scripts.Render(Links.bundles.scripts.jquery)
  @Styles.Render(Links.bundles.scripts.bootstrap)

Support for Minified Javascript files

<script src="<%= Links.Scripts.jquery_1_2_6_js %>" type="text/javascript"></script>

// Logic to determine if the app is running in production or dev environment
public static bool IsProduction() { 
    return (HttpContext.Current != null && !HttpContext.Current.IsDebuggingEnabled); 
}

But you can easily change this logic if you have a different way of determining ‘production’.

2.5 Using T4MVC with "Areas"

One of MVC 2's major new features is the support for breaking up a large application into "Areas". This works by following a structure that looks like:

Root folder
- Areas
  - NerdDinner
    - Models
    - Views
    - Controllers
  - Wiki
    - Models
    - Views
    - Controllers

T4MVC automatically works with your areas and makes them available in its object model. Here is an example:

<%= Html.ActionLink("Delete Dinner", MVC.NerdDinner.Dinners.Delete(Model.DinnerID))%>

<%= Html.ActionLink("Delete Dinner", MVC.Areas.NerdDinner.Dinners.Delete(Model.DinnerID))%>

3. Tweaking the behavior of T4MVC

3.1 Using Model 'unbinders'

public ActionResult Profile(User user) {}
public class User {
  public int Id { get; set; }
  public string Login { get; set; }
}

Here's the typical result of generating an URL for that action with T4MVC:

@Url.Action(MVC.Home.Profile(new User {Id = 1})); // -> /Home/Profile?user=Mvc.HomeController.User

If you'd like to get an URL like /Home/Profile?user=1 you could write a model unbinder, which should implement either IModelUnbinder or IModelUnbinder<T>:

public class UserUnbinder : IModelUnbinder<User>
{
    public void UnbindModel(RouteValueDictionary routeValueDictionary, string routeName, User user)
    {
        if (user != null)
            routeValueDictionary.Add(routeName, user.Id);
    }
}

and then inject it to T4MVC in Application_Start:

ModelUnbinderHelpers.ModelUnbinders.Add(new UserUnbinder());

After that you'll get exactly what described above:

@Url.Action(MVC.Home.Profile(new User {Id = 1})); // -> /Home/Profile?user=1

If you want T4MVC to serialize all the properties of the certain type to url parameters, built-in PropertiesUnbinder could help you do this:

ModelUnbinderHelpers.ModelUnbinders.Add(typeof(User), new PropertiesUnbinder());

In this case you'll get:

@Url.Action(MVC.Home.Profile(new User {Id = 1, Login = "test" })); // -> /Home/Profile?user.Id=1&user.Login=test

which will gently suit the default MVC model binder. T4MVC searches for unbinders through the base types and interfaces that the object implements.

3.2 XML Settings File

3.3 Miscellaneous tweaks

Set SplitIntoMultipleFiles to false to generate a single file with everything

<!-- If true,the template output will be split into multiple files. -->
<SplitIntoMultipleFiles>true</SplitIntoMultipleFiles>

Use HelpersPrefix to change the MVC prefix of the generated classes

<!-- The prefix used for things like MVC.Dinners.Name and MVC.Dinners.Delete(Model.DinnerID) -->
<HelpersPrefix>MVC</HelpersPrefix>

Use ControllersFolder and ViewsRootFolder to rename the Controllers and Views folders

<!-- The folder under the project that contains the controllers -->
<ControllersFolder>Controllers</ControllersFolder>

<!-- The folder under the project that contains the views -->
<ViewsRootFolder>Views</ViewsRootFolder>

Use LinksNamespace the generated links' namespace

<!-- The namespace that the links are generated in (e.g. "Links", as in Links.Content.nerd_jpg) -->
<LinksNamespace>Links</LinksNamespace>

Use StaticFilesFolders to tweak the list of folders from which links are generated

<!-- Folders containing static files for which links are generated (e.g. Links.Scripts.Map_js) -->
<StaticFilesFolders>
    <FileFolder>Scripts</FileFolder>
    <FileFolder>Content</FileFolder>
</StaticFilesFolders>

4. Related resources

David Ebbo has written a series of blog posts on T4MVC
Scott Hanselman also blogged about it here

Updated Wiki: T4MVC_History

davidebbo — Sun, 09 Dec 2012 12:02:07 GMT

T4MVC change history

3.1.0 (12-09-2012):

Added JavaScriptReplacableUrl helper http://t4mvc.codeplex.com/discussions/405911

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post

Updated Wiki: T4MVC_History

davidebbo — Fri, 30 Nov 2012 21:09:54 GMT

T4MVC change history

3.0.3 (11-30-2012):

Fix to deal with multiple attributes http://t4mvc.codeplex.com/SourceControl/network/forks/ArtiomChi/t4mvc/contribution/3723

3.0.2 (11-17-2012):

Add support for generic result types http://t4mvc.codeplex.com/SourceControl/network/forks/ryanrust/T4MVC/contribution/3653

3.0.1 (11-16-2012):

Fix T4MVC.tt.settings.xml so it only gets generated when needed https://t4mvc.codeplex.com/discussions/403390

3.0.0 (11-14-2012):

Move all the non-dynamic code to a separate T4MVCExtensions.dll assembly
Change generated code brace style to Allman
Added many new RouteLink/BeginRouteForm/RouteUrl helpers

2.13.0 (10-24-2012):

Move settings to T4MVC.tt.settings.xml XML file instead of tt file. See doc for details.
Make simple view names available alongside full names, e.g. MVC.Home.Views.SomeView vs MVC.Home.Views.ViewNames.SomeView

2.12.0 (10-16-2012):

Add support for static files in nested folders http://t4mvc.codeplex.com/workitem/6
Add MVC 4 bundle starter classes https://t4mvc.codeplex.com/discussions/399205

2.11.2 (10-11-2012):

Removed optional params in ActionLink to support expression trees http://t4mvc.codeplex.com/workitem/4
Change brace style of generated code to Allman

2.11.1 (10-10-2012):

Ignore methods that return generic types http://mvccontrib.codeplex.com/workitem/7178

2.11.0 (10-09-2012):

Corrects the ActionParameters class for overloaded actions to list all parameters and not just the parameters from the first action found.

2.10.4 (10-05-2012):

Added attributes so it builds clean under Code Analysis http://t4mvc.codeplex.com/workitem/10

2.10.3 (09-30-2012):

Fix crash when querystring contains a null key http://t4mvc.codeplex.com/discussions/396916

2.10.2 (09-17-2012):

Fix UnbindModel to avoid failing on duplicate entries http://t4mvc.codeplex.com/discussions/394529
Fix ModelUnbinder code generation when SplitIntoMultipleFiles is false http://t4mvc.codeplex.com/workitem/9

2.10.1 (07-31-2012):

Fixed default param regression with model unbinder code (http://stackoverflow.com/questions/11566207/t4mvc-optionalparameter-values-implied-from-current-context/11603897)

2.10.0 (07-03-2012):

Added support for custom model binders (https://t4mvc.codeplex.com/discussions/357386)
Fixed unreachable code warning

2.9.0 (06-22-2012):

Added support for minified css files (https://t4mvc.codeplex.com/discussions/360443)
Replaced improper new RouteValueDictionary usage on htmlAttributes

2.8.1 (04-12-2012):

Also default to https for the default (no param) action overload
Make T4MVCHelpers class public so that test code in a different assembly can access it

2.8 (03-25-2012):

Generate parameter constants for action methods. e.g. MVC.MyController.MethodParams.someParam
Default to https for Action Methods marked as RequireHttps (either at controller or action level)

2.7.0 (03-09-2012):

Removed support for MVC earlier than 3, and for CLR earlier than 4.0
Fix ActionLink to work with MVC4 (http://mvccontrib.codeplex.com/workitem/7191)

2.6.68 (02-03-2012):

Ignore static ctors when looking for ctors (http://mvccontrib.codeplex.com/workitem/7185)

2.6.67 (12-24-2011):

Restore Actions token that wasn't obsolete after all. Oops. (http://stackoverflow.com/questions/8625462/t4mvc-actions-token)

2.6.66 (12-22-2011):

Disable constant generation in UseLowercaseRoutes mode (http://stackoverflow.com/questions/8605868/t4mvc-2-6-65-and-uselowercaseroutes-true-error)
Remove obsolete Actions token (http://stackoverflow.com/questions/8536269/what-is-the-difference-between-these-2-definitions-in-t4mvc/8543510)

2.6.65 (12-06-2011):

Add true constant strings for use in attributes (http://mvccontrib.codeplex.com/workitem/7177)

2.6.64 (10-21-2011):

Fix issue when action parameter name is escaped using @ syntax (e.g. int @event)

2.6.63 (10-13-2011):

Move hard coded T4MVC namespace into settings file

2.6.62 (08-13-2011):

Replace some unwanted tab characters with whitespace

2.6.61 (08-01-2011):

Ignore generic action methods (http://mvccontrib.codeplex.com/workitem/7156)

2.6.60 (07-28-2011):

Added support for portable areas. Enabled by adding area names to PortableAreas in T4MVC.tt.settings.t4
When generating links and views, if the folder name is the same as the parent, add a modifier to avoid class name conflicts (http://mvccontrib.codeplex.com/workitem/7153)

2.6.59 (07-12-2011):

Added commented out logic to show how to debug into the template (http://mvccontrib.codeplex.com/workitem/7144)
Ignore any class which name doesn't end with "Controller"

2.6.58 (06-24-2011):

Change the controller detection logic to be more reliable and ignore anything that doesn't extend Controller.

2.6.57 (06-21-2011):

Re-added Html.ActionLink/Url.Action overload without default params to avoid running into "CS0854: An expression tree may not contain a call or invocation that uses optional arguments"
Make ProcessControllerActionMethods look for ControllerBase instead of Controller to support controllers like MailerBase (from ActionMailer) which extend ControllerBase.

2.6.56 (06-05-2011):

Added optional Html.ActionLink parameters for protocol, hostname and fragment (http://stackoverflow.com/questions/6280347/how-can-i-add-a-hash-fragment-to-t4mvc-route-dictionary-actionresult/6302703)

2.6.55 (06-05-2011):

Added optional Url.Action parameters for protocol and hostname (http://stackoverflow.com/questions/6240568/t4mvc-doesnt-work-property-with-url-action)

2.6.54 (04-23-2011):

Added missing license to NuGet package and fixed some links. No actual template changes!

2.6.53 (04-18-2011):

Ignore actions marked as obsolete (http://mvccontrib.codeplex.com/workitem/7133)

2.6.52 (04-14-2011):

Moved the 'Dummy' class under the GenerateMvcT4Extensions check
Always include the area token in the route values unless running on MVC 1.x

2.6.51 (04-12-2011):

Ignore async completion methods as they can't really be used in T4MVC, and can cause issues (http://stackoverflow.com/questions/5419173/t4mvc-asynccontroller)

2.6.50 (04-08-2011):

Added AddTimestampToStaticLink() method to settings file to allow more granular decision (per this post)
Added GenerateMvcT4Extensions settings flag to omit the generation of the System.Web.Mvc.T4Extensions class, which can be useful if it is already defined in a referenced library (see this post)

2.6.44 (03-10-2011):

Added UseNonQualifiedViewNames flag which when set to true causes view names never to be fully qualified. Spark users may need that.

2.6.43 (02-24-2011):

Renamed T4MVC.settings.t4 to T4MVC.tt.settings.t4 so it feels more like a 'child' file of T4MVC.tt

2.6.42 (02-01-2011):

Fix partial view support for MVC
Fix partial view support when name has periods (http://mvccontrib.codeplex.com/workitem/7113)

2.6.41 (01-17-2011):

Added AJAX BeginForm overloads

2.6.40 (01-05-2011):

Added BeginForm overload that just takes an ActionResult
Fix MapRouteArea to use UseNamespaceFallback when there are no namespaces

2.6.32 (12-15-2010):

Fix bug in controller name generation when IncludeAreasToken is true

2.6.31 (11-15-2010):

Improve error message when T4MVC generated files are out of date.
Changed some 'const bool' settings to 'static bool' to avoid unused code warnings.
Disabled regen optimization added in 2.6.14 since it doesn't catch view changes

2.6.30 (09-05-2010):

Changed ExplicitHtmlHelpersForPartials flag to be off by default (and fix a small issue when it's off)
Handled System.NotImplementedException if project type (e.g. Installer) does not implement CodeModel property
Fixed issue when action method params are all optional (http://stackoverflow.com/questions/3488610/t4mvc-and-named-parameters)
Exclude Area related methods when using MVC 1.0, as that was breaking things
Added logic to special case DisplayTemplates/EditorTemplates folders, since they need short view names passed in

2.6.21 (07-20-2010):

Fix to the partial extension feature added in 2.6.20 to deal with conflicts

2.6.20 (07-19-2010):

Added extension methods to render partial views (see this post)
- e.g. Html.RenderPartial("Map", Model.Dinner); --> Html.RenderMap(Model.Dinner);
- Can be turned off in settings file via ExplicitHtmlHelpersForPartials flag.

2.6.15 (05-16-2010):

Added missing MapRoute overloads to support namespaces
Added MapRoute extensions on AreaRegistrationContext to support areas. Had to name them MapRouteArea to avoid clash with existing MapRoute methods :(

2.6.14 (05-06-2010):

Added UseLowercaseRoutes flag to lower case the area, controller and action names in routes
Added support for Views folders that don't match a controller name.
Added optimization to not regenerate files when the controller has not changed since the last generation
Turn AlwaysKeepTemplateDirty to false by default. We now have an addin which provides a better solution to this

2.6.13 (03-08-2010):

Added AddTimestampToStaticLinks flag to T4MVC.settings.t4 to generate static links that change when the file changes.
Added support for [Bind(Prefix = "newParamName")] attribute so it generates the correct route value
Added an AddRouteValues overload that takes NameValueCollection, e.g.
- MVC.Home.About().AddRouteValues(Request.QueryString)
Added MapRoute overload that supports contraints
Removed some logic to support VS2010 Beta 2. VS2010 RC or later should now be used.

2.6.12 (01-15-2010):

Fixed issue where some special project types (e.g. DB projects) were throwing while enumerating over the list
Changed to use GeneratedCode attribute instead of the less correct CompilerGenerated
Fixed CompilerGenerated/DebuggerNonUserCode attributes so they don't incorrectly affect the control classes
Change to avoid adding area to route if the app is not using areas

2.6.11 (01-10-2010):

Added ExcludedStaticFileExtensions setting to T4MVC.settings.t4 to list extensions for which static links should not be generated.
Support configurable name for IT4MVCActionResult, and it being defined externally (for sharing pourpose)
Added DebuggerNonUserCode attribute to generated classes
Improved error handling when trying to call T4MVC method with real ActionResult (previous threw InvalidCast)
Fix issue when overridden action methods were incorrectly marked as virtual

2.6.10 (01-04-2010):

Added support for adding arbitrary route parameters to T4MVC actions. e.g.
- MVC.Home.About().AddRouteValue("fooKey", bar.Foo.Key)
- MVC.Home.About().AddRouteValues(new {fooKey = bar.Foo.Key, barKey = bar.Key})
Added shorter to refer to controller actions from with the controller itself. e.g.
- return RedirectToAction(MVC.MyController.Actions.About()); BECOMES:
- return RedirectToAction(Actions.About());
What was previously called Actions was renamed to ActionNames (note, that's a BREAKING CHANGE if you used Actions before!)
Ignore controller methods that are marked with a NonAction attribute
Renamed IT4MVCActionResult.RouteValues to avoid conflict (this should not break anything, as it's only used internally)

2.6.03 (12-10-2009):

Generate full view paths to allow cross controller references
- e.g. MVC.Dinners.Views.DinnerForm is now "~/Views/Dinners/DinnerForm.ascx" instead of just "DinnerForm"
Fix compile error when a view name is a language keyword (e.g. string.ascx)

2.6.02 (12-04-2009)

Added way to get area name from both Area and Controller objects
- e.g. MVC.MyArea.Name and MVC.MyArea.MyController.Area
Added support for controllers in the default namespace (i.e. no namespace)
Always include the area in the route data, even when it's null/empty

2.6.01 (12-02-2009)

Fix compile error when a custom ActionResult type has a ctor that takes a value type

2.6.00 (11-28-2009)

Added support for MVC 2 Areas
Fixed issue where non-existing RenderAction method gets generated on VS2010 Beta 2
Added check to give proper error when attempting to run T4MVC outside VS (e.g. from TextTransform.exe)

2.5.02 (11-24-2009)

Change links in comment to point to new T4MVC home and forum
Fix scenario where a View folder as a name that's a C# keyword

2.5.01 (11-20-2009)

Added support for Html.RenderAction and Html.Action (see http://haacked.com/archive/2009/11/18/aspnetmvc2-render-action.aspx)
Fix null ref exception issue when custom ActionResult type doesn't have any explicit ctors

2.5.00 (11-16-2009)

Incorporated Damien Guard's multiple output manager to (optionally) split output from T4MVC into separate files to improve source control
Added support for minified javascript files in production
Fixed bug occurring when no action is of type ActionResult

2.4.04 (10-15-2009)

Added support for MVC 2 by detecting the version and generating slightly different code

2.4.03 (10-02-2009)

Added ProcessVirtualPath method to T4MVC.settings.t4 so user can write custom logic to modify client URL's
Greatly simplified GetProjectContainingT4File logic by using FindProjectItem().
Renamed generated classes to be CLS compliant
Moved most of the doc and versioning comments from T4MVC.tt into the readme.txt file, as it was getting a bit long.

2.4.02 (09-02-2009)

Added a setting in T4MVC.settings.t4 to set the namespace that Links get generated in
Added pragma to prevent compiler from complaining about missing Xml comments
Added <auto-generated /> comment to disable StyleCop in generated file
Fixed issue when using a custom ResultType in a custom namespace. Now fully qualifying result types.

2.4.01 (07-29-2009):

Put all the generated code in a T4MVC #region. This is useful to tell tools like ReSharper to ignore it.
Fixed issue where controller methods returning generic types cause template to blow up
Added a setting in T4MVC.settings.t4 to turn off the behavior that always keeps the template dirty

2.4.00 (07-28-2009):

Added support for configurable settings in a separate T4MVC.settings.t4 file
Added a parameter-less pseudo-action for every action that doesn't already have a parameter-less overload
Added support for having T4MVC.tt in a sub folder instead of always at the root of the project
Fixed issue when a base controller doesn't have a default ctor
Added T4Extensions into System.Web.Mvc namespace to fix ambiguous resolution issue
Misc cleanup

2.3.01 (07-10-2009):

Fixed issue with ActionName attribute set to non literal string values (e.g. ActionName(SomeConst + "Abc"))
Fixed duplication issue when partial controller classes have a base type which contains action methods
Skip App_LocalResources when processing views
Cleaned up rendering logic

2.3.00 (07-07-2009):

Added support for sub view folders
Added support for ActionName attribute
Improved handling when the controller comes from a different project
Don't try to process generic controller classes

2.2.03 (07-06-2009):

Added support for action methods defined on controller base classes
Improved error handling when not able to change actions to virtual and controllers to partial

2.2.02 (07-01-2009):

Fixed break caused by incorrect support for derived ActionResult types in 2.2.01
Fixed issue with duplicate view tokens getting generated when you have both foo.aspx and foo.ascx

2.2.01 (07-01-2009):

Added support for action methods that return a type derived from ActionResult (as opposed to exactly an ActionResult)
Fixed issue when controller is using partial classes
Fixed folder handling logic to deal with generated files
Fixed issue with folder names that are C# keyword
Throw NotSupportedException instead of NotImplementedException to avoid being viewed as a TODO

2.2.00 (06-30-2009):

Added strongly typed support to MapRoute
Changed constructor generation to avoid confusing IoC containers
Fixed issue with empty Content folder
Fixed issue with abstract controller base classes

2.1.00 (06-29-2009):

Added Html.BeginForm overloads that use the strongly typed pattern
Added Url() helpers on static resources to increase flexibility
Changed generated constants (view and action names, static files) to be readonly strings
Fixed null ref exception in Solution Folder logic

2.0.04 (06-28-2009):

Fixed issue with files and folders with names starting with a digit

2.0.03 (06-27-2009):

Rework code element enumeration logic to work around a VS2010 issue. The template should now work with VS2010 beta 1!
Reduced some redundancy in the generated code

2.0.02 (06-27-2009):

Added ActionLink overloads that take object instead of dictionary (from both Html and Ajax)

2.0.01 (06-26-2009):

Fixed issue with files and folders with invalid identifier characters (e.g. spaces, '-', '.')

2.0.00 (06-26-2009):

Added support for refactoring in Action methods
The T4 file automatically runs whenever you build, instead of being done manually
Support for strongly typed links to static resources
Fix: supports controllers that are in sub-folders of the Controllers folder and not directly in there
Fix: works better with nested solution folder
Random other small fixes

1.0.xx (06-17-2009):

the original based on this post