System.Net.HttpStatusCode与Microsoft.AspNetCore.Http.StatusCodes的区别及适用场景

核心区别 #

• 类型本质
  • System.Net.HttpStatusCode 是.NET基础类库提供的枚举类型，每个枚举项对应一个标准HTTP状态码，使用时需要通过(int)强制转换才能获取对应的数值。
  • Microsoft.AspNetCore.Http.StatusCodes 是ASP.NET Core框架提供的静态类，内部封装了所有HTTP状态码的int类型静态常量，直接引用即可拿到数值，无需转换。
• 覆盖范围
  • HttpStatusCode 仅覆盖常见的标准HTTP状态码，对于WebDAV这类扩展状态码（如423 Locked、422 Unprocessable Entity等）没有定义。
  • StatusCodes 不仅包含所有标准HTTP状态码，还补充了WebDAV相关的扩展状态码，覆盖范围更全面。

适用场景 #

优先用HttpStatusCode的情况

• 跨.NET平台开发场景：比如代码需要在桌面应用、非ASP.NET Core的Web项目中复用，它属于.NET基础类库，通用性更强。
• 对接System.Net命名空间下的API时：比如处理HttpClient的响应结果，用这个枚举能和API的返回类型更好匹配。

优先用StatusCodes的情况

• ASP.NET Core项目内部开发：比如控制器返回StatusCodeResult、设置HttpContext.Response.StatusCode时，直接使用静态常量更简洁，省去强制转换的步骤，代码可读性更高。
• 需要使用WebDAV等扩展状态码时：这类特殊状态码只有StatusCodes里有定义。

代码示例优化 #

你提供的代码存在语法问题（缺少分号），修正后对比两种写法：

using System.Net;
using Microsoft.AspNetCore.Http;

public class MyClass
{
    public string GetStatusCodeMessage()
    {
        // 直接使用静态常量，无需转换
        int statusCode_1 = StatusCodes.Status409Conflict;
        // 需要强制转换为int类型
        int statusCode_2 = (int)HttpStatusCode.Conflict;

        // 在ASP.NET Core项目里更推荐用StatusCodes
        return $"There is a {statusCode_1} here.";
    }
}

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