Asp.Net Core中IFormFile属性绑定失败，图片转byte[]未执行问题

问题背景 #

定义了用于数据库存储的基类：

public class BlogData
{
    public int Id { get; set; }
    public string BlogTitle { get; set; }
    public string BlogContent { get; set; }
    public DateTime PostedDateTime { get; set; }
    public byte[] ImageData { get; set; }
}

继承该基类创建子类，意图在ActualImage属性绑定值时自动将文件转换为byte[]存入ImageData：

public class BlogDataWithStringImage : BlogData
{
    private IFormFile _actualImage;
    public IFormFile ActualImage
    {
        get => _actualImage;
        set
        {
            if (value != null)
            {
                using var fs1 = value.OpenReadStream();
                using var ms1 = new MemoryStream();
                fs1.CopyTo(ms1);
                ImageData = ms1.ToArray();
            }
            _actualImage = value;
        }
    }
}

视图使用子类作为模型，表单已设置enctype="multipart/form-data"，但选择图片提交后，ActualImage的set块断点始终未触发：

@model KGSBlog.Models.BlogDataWithStringImage

@{
    ViewData["Title"] = "Create";
}

<h1>Create</h1>

<h4>BlogData</h4>
<hr />
<div class="row">
    <div class="col-md-4">
        <form asp-action="Create" enctype="multipart/form-data">
            <div asp-validation-summary="ModelOnly" class="text-danger"></div>
            <div class="form-group">
                <label asp-for="BlogTitle" class="control-label"></label>
                <input asp-for="BlogTitle" class="form-control" />
                <span asp-validation-for="BlogTitle" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="BlogContent" class="control-label"></label>
                <input asp-for="BlogContent" class="form-control" />
                <span asp-validation-for="BlogContent" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="PostedDateTime" class="control-label"></label>
                <input asp-for="PostedDateTime" class="form-control" />
                <span asp-validation-for="PostedDateTime" class="text-danger"></span>
            </div>
            <div class="col-md-12">
                <div class="form-group">
                    <label asp-for="ActualImage" class="control-label"></label>
                    <div class="custom-file">
                        <input asp-for="ActualImage" class="custom-file-input" id="customFile">
                        <label class="custom-file-label" for="customFile">Choose file</label>
                    </div>
                    <span asp-validation-for="ActualImage" class="text-danger"></span>
                </div>
            </div>
            <div class="form-group">
                <input type="submit" value="Create" class="btn btn-primary" />
            </div>
        </form>
    </div>
</div>

<div>
    <a asp-action="Index">Back to List</a>
</div>

@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}

原因分析 #

最常见的触发该问题的原因是控制器Action的参数类型错误：如果Create Action接收的是基类BlogData而非子类BlogDataWithStringImage，模型绑定器会创建基类实例，子类的ActualImage属性不会被识别和绑定，自然不会触发set块。

此外，属性setter中包含文件流读取的IO操作，模型绑定阶段执行这类操作并非Asp.Net Core的最佳实践，可能因绑定机制的内部逻辑导致setter未被正常调用。

解决方案 #

方案1：修正Action参数类型 #

确保控制器的Create Action使用子类作为参数，让模型绑定器正确识别并绑定子类属性：

[HttpPost]
[ValidateAntiForgeryToken]
public IActionResult Create(BlogDataWithStringImage model)
{
    if (ModelState.IsValid)
    {
        // 此时ActualImage的set块已触发，ImageData已赋值
        _context.Add(model);
        _context.SaveChanges();
        return RedirectToAction(nameof(Index));
    }
    return View(model);
}

方案2：将转换逻辑移至Action中（推荐） #

将文件转byte[]的逻辑从属性setter移到Action内，避免在模型绑定阶段执行IO操作，代码更清晰且易于维护：

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create(BlogDataWithStringImage model)
{
    if (ModelState.IsValid)
    {
        if (model.ActualImage != null)
        {
            using var memoryStream = new MemoryStream();
            await model.ActualImage.CopyToAsync(memoryStream);
            model.ImageData = memoryStream.ToArray();
        }
        
        _context.Add(model);
        await _context.SaveChangesAsync();
        return RedirectToAction(nameof(Index));
    }
    return View(model);
}

额外检查项 #

• 确认表单的enctype="multipart/form-data"已正确设置（你的视图中已配置），这是IFormFile绑定的必要条件。
• 在浏览器开发者工具中查看表单提交时的请求，确认ActualImage字段的名称和值是否正确传递。

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