ASP.NET Core 8 Minimal API中[FromForm]绑定值对象属性失败求助

1. 修复TryParse方法的逻辑与签名 #

你的ContactId.TryParse方法存在两处问题：不符合TryParse语义（失败时不应抛出异常，需返回false），且缺少ASP.NET Core模型绑定所需的重载。修改后的代码如下：

public static bool TryParse(string? value, out ContactId id)
{
    id = default;
    if (string.IsNullOrWhiteSpace(value))
        return false;
    
    if (int.TryParse(value, out var intValue))
    {
        id = new ContactId(intValue);
        return true;
    }
    return false;
}

// 添加模型绑定需要的带IFormatProvider的重载
public static bool TryParse(string? value, IFormatProvider? provider, out ContactId id)
{
    return TryParse(value, out id);
}

2. 验证自动生成的TypeConverter #

你使用了StronglyTypedIdConverter.TypeConverter标记，工具会自动生成ContactIdTypeConverter类。确保生成的代码包含正确的ConvertFrom实现，示例如下（自动生成代码通常包含类似逻辑）：

public class ContactIdTypeConverter : TypeConverter
{
    public override bool CanConvertFrom(ITypeDescriptorContext? context, Type sourceType)
    {
        return sourceType == typeof(string) || base.CanConvertFrom(context, sourceType);
    }

    public override object? ConvertFrom(ITypeDescriptorContext? context, CultureInfo? culture, object value)
    {
        if (value is string strValue && ContactId.TryParse(strValue, out var id))
        {
            return id;
        }
        return base.ConvertFrom(context, culture, value);
    }
}

如果生成的TypeConverter缺失或逻辑错误，可手动创建并在ContactId上添加[TypeConverter(typeof(ContactIdTypeConverter))]特性。

3. 注册全局模型绑定器（可选，若前两步无效） #

若上述方法仍无法解决问题，可为ContactId注册自定义模型绑定器，强制处理FromForm场景的绑定：

创建模型绑定器 #

public class ContactIdModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
            return Task.CompletedTask;

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);
        var value = valueProviderResult.FirstValue;

        if (ContactId.TryParse(value, out var contactId))
        {
            bindingContext.Result = ModelBindingResult.Success(contactId);
        }
        else
        {
            bindingContext.ModelState.TryAddModelError(
                bindingContext.ModelName, 
                $"输入值无法转换为有效的{nameof(ContactId)}");
        }

        return Task.CompletedTask;
    }
}

在Program.cs中注册绑定器 #

builder.Services.AddControllers(options =>
{
    options.ModelBinderProviders.Insert(0, new BinderTypeModelBinderProvider(
        typeof(ContactId), 
        new ContactIdModelBinder()));
});

4. 验证表单字段传递 #

确保前端提交的表单中，对应Id字段的键名与Command类的Id属性名一致，且值为有效的整数字符串（如"123"）。

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