如何在ASP.NET Core 2中实现RenderPartialToString（渲染PartialView为字符串）？

嘿，我之前在ASP.NET Core 2项目里正好做过把PartialView转成字符串的需求，这个方案经过项目验证，挺稳定的，给你一步步拆解：

1. 创建视图渲染服务接口与实现类 #

首先我们需要一个服务来封装视图渲染的逻辑，先定义接口，再写具体实现：

接口定义 #

public interface IViewRenderService
{
    Task<string> RenderToStringAsync(string viewName, object model);
}

实现类 #

这个类需要依赖ASP.NET Core的视图引擎、临时数据提供器和HttpContext访问器，代码如下：

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Abstractions;
using Microsoft.AspNetCore.Mvc.ModelBinding;
using Microsoft.AspNetCore.Mvc.Razor;
using Microsoft.AspNetCore.Mvc.Rendering;
using Microsoft.AspNetCore.Mvc.ViewFeatures;
using Microsoft.AspNetCore.Routing;
using System.IO;
using System.Threading.Tasks;

public class ViewRenderService : IViewRenderService
{
    private readonly IRazorViewEngine _razorViewEngine;
    private readonly ITempDataProvider _tempDataProvider;
    private readonly IHttpContextAccessor _httpContextAccessor;

    public ViewRenderService(IRazorViewEngine razorViewEngine,
                             ITempDataProvider tempDataProvider,
                             IHttpContextAccessor httpContextAccessor)
    {
        _razorViewEngine = razorViewEngine;
        _tempDataProvider = tempDataProvider;
        _httpContextAccessor = httpContextAccessor;
    }

    public async Task<string> RenderToStringAsync(string viewName, object model)
    {
        var httpContext = _httpContextAccessor.HttpContext ?? new DefaultHttpContext();
        var actionContext = new ActionContext(httpContext, new RouteData(), new ActionDescriptor());

        using (var sw = new StringWriter())
        {
            var viewResult = _razorViewEngine.FindView(actionContext, viewName, false);

            if (!viewResult.Success)
            {
                throw new System.InvalidOperationException($"找不到视图: {viewName}");
            }

            var viewDictionary = new ViewDataDictionary(new EmptyModelMetadataProvider(), new ModelStateDictionary())
            {
                Model = model
            };

            var viewContext = new ViewContext(
                actionContext,
                viewResult.View,
                viewDictionary,
                new TempDataDictionary(actionContext.HttpContext, _tempDataProvider),
                sw,
                new HtmlHelperOptions()
            );

            await viewResult.View.RenderAsync(viewContext);
            return sw.ToString();
        }
    }
}

2. 在Startup中注册服务 #

打开Startup.cs，在ConfigureServices方法里添加服务注册：

public void ConfigureServices(IServiceCollection services)
{
    // 其他服务注册...
    
    // 注册视图渲染服务
    services.AddScoped<IViewRenderService, ViewRenderService>();
    // 注册HttpContextAccessor（ASP.NET Core 2需要手动注册，后续版本默认已注册）
    services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>();
}

注意：ASP.NET Core 2中IHttpContextAccessor默认没有注册，所以必须手动添加这一行，不然会出现依赖注入失败的问题！

3. 在控制器中使用服务 #

现在你可以在控制器里注入IViewRenderService，然后调用方法渲染PartialView了：

public class HomeController : Controller
{
    private readonly IViewRenderService _viewRenderService;

    public HomeController(IViewRenderService viewRenderService)
    {
        _viewRenderService = viewRenderService;
    }

    public async Task<IActionResult> Index()
    {
        // 准备PartialView需要的模型
        var model = new MyViewModel { Name = "测试数据" };
        
        // 渲染PartialView为字符串，视图路径要写对，比如Shared文件夹下的_MyPartial.cshtml
        var partialViewString = await _viewRenderService.RenderToStringAsync("~/Views/Shared/_MyPartial.cshtml", model);
        
        // 这里可以把字符串用于邮件模板、返回给前端等场景
        ViewBag.PartialHtml = partialViewString;
        return View();
    }
}

注意事项 #

• 视图路径必须正确：推荐使用~/开头的绝对路径，比如~/Views/YourController/_YourPartial.cshtml，避免视图引擎找不到文件。
• 模型要匹配：确保传入的模型和PartialView的@model类型一致，不然会出现模型绑定错误。
• 非控制器环境使用：如果要在后台任务等没有HttpContext的场景使用，需要手动构建HttpContext（比如在RenderToStringAsync里创建新的DefaultHttpContext并设置必要的属性）。

内容的提问来源于stack exchange，提问作者Beginner