.NET3.1迁移至.NET8类库：IFormCollection转NameValueCollection报错

问题场景 #

将.NET 3.1代码移植到.NET 8类库时，原有读取表单的代码出现类型转换错误。

原有代码 #

private static void ReadForm(Dictionary<string, GatewayParameter> gatewayParameterList)
{
    NameValueCollection form = HttpContext.Request.Form;
    foreach (string item in form.AllKeys)
    {
        SetGatewayParameterValue(gatewayParameterList, item, form[item], HttpMethod.Post);
    }
}

错误信息 #

Error CS0266 Cannot implicitly convert type 'Microsoft.AspNetCore.Http.IFormCollection' to 'System.Collections.Specialized.NameValueCollection'. An explicit conversion exists (are you missing a cast?)

疑问 #

原本认为HttpContext.Request.Form返回NameValueCollection，为何会出现该错误？

原因及解决方法 #

错误原因 #

你混淆了不同.NET平台的表单类型：

• 在传统.NET Framework的ASP.NET中，Request.Form确实返回NameValueCollection；
• 但从.NET Core（包括.NET 3.1、.NET 8等）开始，ASP.NET Core使用IFormCollection处理表单数据，它和NameValueCollection是完全独立的类型，不存在隐式转换关系。

解决方法 #

方法1：直接使用IFormCollection（推荐）

IFormCollection原生适配ASP.NET Core的表单逻辑，支持遍历键值对，修改代码如下：

private static void ReadForm(Dictionary<string, GatewayParameter> gatewayParameterList)
{
    IFormCollection form = HttpContext.Request.Form;
    foreach (var kvp in form)
    {
        // StringValues支持单个键对应多个值，这里取第一个值或按需处理
        string value = kvp.Value.ToString();
        SetGatewayParameterValue(gatewayParameterList, kvp.Key, value, HttpMethod.Post);
    }
}

方法2：手动转换为NameValueCollection

如果需要保留原有遍历逻辑，可以手动将IFormCollection转换为NameValueCollection：

private static void ReadForm(Dictionary<string, GatewayParameter> gatewayParameterList)
{
    IFormCollection formCollection = HttpContext.Request.Form;
    NameValueCollection form = new NameValueCollection();
    
    foreach (var kvp in formCollection)
    {
        form.Add(kvp.Key, kvp.Value.ToString());
    }
    
    foreach (string item in form.AllKeys)
    {
        SetGatewayParameterValue(gatewayParameterList, item, form[item], HttpMethod.Post);
    }
}

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