如何在.NET Framework 4.7.2 MVC项目中使用.NET Standard 2的IFormFile

问题背景 #

我们正将若干旧版.NET Framework 4.7.2 Web应用迁移至.NET Core，采用.NET Standard 2类库先更新基础设施，目前领域、业务和数据层均为.NET Standard 2，而Web站点仍基于.NET Framework。站点中存在文件上传功能，原页面ViewModel的文件属性定义为HttpPostedFileBase，为适配.NET Standard已改为IFormFile，但上传文件时出现模型验证错误。

错误信息 #

The parameter conversion from type 'System.Web.HttpPostedFileWrapper' to type 'Microsoft.AspNetCore.Http.IFormFile' failed because no type converter can convert between these types.

ViewModel代码 #

public class MarketingDocRequestViewModel
{
       public string CompanyName { get; set; }

       public string FirstName {get;set;}

       public string LastName {get;set;}

       public string Address1 { get; set; }

       public string Address2 { get; set; }

       public string City { get; set; }

       public string State { get; set; }

       public string Zip { get; set; }

       public string Phone { get; set; }

       public string Fax { get; set; }

       public string EmailAddress { get; set; }

       public string Website { get; set; }

       public IFormFile LogoFile { get; set; }
}

解决方案 #

IFormFile是ASP.NET Core专属的抽象类型，和.NET Framework的HttpPostedFileBase分属不同框架体系，没有内置类型转换器，可通过以下几种方式解决：

方案1：实现IFormFile适配类包装HttpPostedFileBase #

自定义一个实现IFormFile接口的适配类，把HttpPostedFileBase的功能映射到接口要求的成员上，让.NET Framework端的上传文件能适配ViewModel的IFormFile属性。

适配类示例：

public class HttpPostedFileBaseAdapter : IFormFile
{
    private readonly HttpPostedFileBase _sourceFile;

    public HttpPostedFileBaseAdapter(HttpPostedFileBase sourceFile)
    {
        _sourceFile = sourceFile ?? throw new ArgumentNullException(nameof(sourceFile));
    }

    public string ContentType => _sourceFile.ContentType;
    public string ContentDisposition => $"form-data; name=\"{_sourceFile.Name}\"; filename=\"{_sourceFile.FileName}\"";
    public IHeaderDictionary Headers => new HeaderDictionary { { "Content-Type", ContentType } };
    public long Length => _sourceFile.ContentLength;
    public string Name => _sourceFile.Name;
    public string FileName => _sourceFile.FileName;

    public Stream OpenReadStream() => _sourceFile.InputStream;

    public void CopyTo(Stream target) => _sourceFile.InputStream.CopyTo(target);

    public Task CopyToAsync(Stream target, CancellationToken cancellationToken = default)
    {
        return _sourceFile.InputStream.CopyToAsync(target, cancellationToken);
    }
}

控制器中手动转换并重新验证模型：

[HttpPost]
public ActionResult Submit(MarketingDocRequestViewModel model)
{
    // 模型绑定失败时，手动处理文件属性
    if (!ModelState.IsValid && Request.Files["LogoFile"] != null)
    {
        var postedFile = Request.Files["LogoFile"];
        if (postedFile.ContentLength > 0)
        {
            model.LogoFile = new HttpPostedFileBaseAdapter(postedFile);
            // 清除原有验证状态，重新验证模型
            ModelState.Clear();
            TryValidateModel(model);
        }
    }

    if (ModelState.IsValid)
    {
        // 执行业务逻辑
        return RedirectToAction("Success");
    }

    return View(model);
}

方案2：拆分ViewModel，按框架分别定义 #

针对混合框架阶段的现状，为.NET Framework和.NET Core分别创建ViewModel，共享通用属性，仅文件属性使用对应框架的类型，再通过映射工具（如AutoMapper）转换到业务层的.NET Standard模型。

示例代码：

// .NET Framework专用ViewModel
public class MarketingDocRequestAspNetViewModel
{
    public string CompanyName { get; set; }
    // 其他通用属性...
    public HttpPostedFileBase LogoFile { get; set; }
}

// .NET Core专用ViewModel（迁移完成后使用）
public class MarketingDocRequestAspNetCoreViewModel
{
    public string CompanyName { get; set; }
    // 其他通用属性...
    public IFormFile LogoFile { get; set; }
}

// 业务层.NET Standard模型
public class MarketingDocRequestModel
{
    public string CompanyName { get; set; }
    // 其他通用属性...
    public Stream LogoStream { get; set; }
    public string LogoFileName { get; set; }
    public string LogoContentType { get; set; }
}

.NET Framework控制器中完成模型转换：

[HttpPost]
public ActionResult Submit(MarketingDocRequestAspNetViewModel model)
{
    if (ModelState.IsValid)
    {
        var businessModel = new MarketingDocRequestModel
        {
            CompanyName = model.CompanyName,
            // 映射其他通用属性...
            LogoStream = model.LogoFile?.InputStream,
            LogoFileName = model.LogoFile?.FileName,
            LogoContentType = model.LogoFile?.ContentType
        };

        _marketingService.ProcessRequest(businessModel);
        return RedirectToAction("Success");
    }

    return View(model);
}

方案3：暂时保留双属性，迁移完成后统一 #

如果当前不想做大量改动，可以在ViewModel中同时保留HttpPostedFileBase和IFormFile属性，通过手动同步的方式适配，等Web站点完全迁移到.NET Core后再统一替换为IFormFile。

修改后的ViewModel：

public class MarketingDocRequestViewModel
{
    // 其他通用属性...

    // .NET Framework端使用
    public HttpPostedFileBase LogoFileLegacy { get; set; }

    // .NET Core端及业务层使用
    public IFormFile LogoFile { get; set; }

    // 同步文件属性
    public void SyncFileProperties()
    {
        if (LogoFileLegacy != null)
        {
            LogoFile = new HttpPostedFileBaseAdapter(LogoFileLegacy);
        }
    }
}

控制器中调用同步方法后再处理业务：

[HttpPost]
public ActionResult Submit(MarketingDocRequestViewModel model)
{
    model.SyncFileProperties();
    if (ModelState.IsValid)
    {
        // 执行业务逻辑
        return RedirectToAction("Success");
    }
    return View(model);
}

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