RenderPartial to String in ASP.NET MVC

October 12th, 2009 by Kevin

About a year ago I released some code that allowed you to render a partial view to a string inside your controllers in ASP.NET MVC (beta, at the time). While this solution worked, it required a whole bunch of code to achieve a fairly simple goal. Well, a lot has changed in the MVC world, and rendering a partial view to string has, thankfully, become much, much easier. (Thanks to Martin where I originally got this code from!)

Below is the code I am now using to create my RenderPartialToString method:

/// Static Method to render string - put somewhere of your choosing
public static string RenderPartialToString(string controlName, object viewData)
{
     ViewDataDictionary vd = new ViewDataDictionary(viewData);
     ViewPage vp = new ViewPage { ViewData = vd };
     Control control = vp.LoadControl(controlName);

     vp.Controls.Add(control);

     StringBuilder sb = new StringBuilder();
     using (StringWriter sw = new StringWriter(sb))
     {
         using (HtmlTextWriter tw = new HtmlTextWriter(sw))
         {
             vp.RenderControl(tw);
         }
     }

     return sb.ToString();
}

As you can see, this method is much shorter and doesn’t have any sort of additional library contingencies. Pass it a path reference to your partial view and ViewData object (maybe you want that, maybe you don’t) and away you go. The following is an example of how to call the above method from your controller:

// Controller Method
public string Create()
{
     {...}
     var viewData = new SomeViewData { Note = n };

     string s = RenderPartialToString("~/Views/Clients/Notes/ClientNotesRow.ascx", viewData);

     return s;
}

That’s all there is to it!

Dan Atkinson October 13th, 2009 at 5:23 am

You link from your last blog post, but this isn’t the same as rendering a view to a string.

This is just rendering a partial as views don’t extend Control.

So, if you wanted to actually generate an entire view into a string, you’d still need to use the old method. That or rework your views to be partials instead…

Kevin October 13th, 2009 at 9:01 am

Hey Dan,

As far as I know, your point is quite valid. If you want to render an entire view to a string, the previous post will work and this one will not.

However, the idea behind RenderPartialToString, is geared at just that, rendering a partial view to a string.

Brian October 27th, 2009 at 11:01 pm

When I tried to use this code I had to change this line:
ViewDataDictionary vd = new ViewDataDictionary(viewData);

To:
ViewPage vp = new ViewPage { ViewData = (ViewDataDictionary)viewData };

Not sure why but when I created the ViewDataDictionary object with the constructor I was losing all of viewData’s parameters.

Gary Davis December 4th, 2009 at 10:05 am

This worked nicely except when the ascx control used an Html helper (). Html was null causing a Null-ref trap.

The trap did not occur if the control was referenced by Html.RenderPartial() instead of RenderPartialToString().

Gary

Gary Davis December 4th, 2009 at 10:37 am

Based on what I read in your reference, I made these changes to solve the trap:

public static string RenderPartialToString(this HtmlHelper htmlHelper, string controlName, object viewData) { // Added Url to allow ascx to use Url.Action() var urlHelper = new UrlHelper(htmlHelper.ViewContext.RequestContext); // Added ViewContext to allow ascx to use Html helpers var vp = new ViewPage { ViewData = vd, ViewContext = htmlHelper.ViewContext, Url = urlHelper};

Note this is an Html helper called with Html.RenderPartialToString(). If not, use these changes:

var vc = new ViewContext(); // Added Url to allow ascx to use Url.Action() var urlHelper = new UrlHelper(vc.RequestContext); // Added ViewContext to allow ascx to use Html helpers var vp = new ViewPage { ViewData = vd, ViewContext = vc, Url = urlHelper };

Gary