c# - 值元组从 WebAPI 公开错误的参数名称

Question

我正在使用网络 API。我有点懒惰，决定从我的 Controller 返回一个值元组。

[HttpGet]
[Route(AuthAPIRoutes.GET_MFA_DEVICES)]
public (string Type, string Value)[] GetMultiFactoryMethods()
{
    return GlobalFactory<IPaystreamMFASecurityService>.Instance.GetMultiFactorMethods();
}

JSON 响应似乎没有使用适当的命名，这是否正在优化？

{
    "item1": "Phone",
    "item2": "1-512-555-0550"
}

注意:我知道我可以明确地制作一个模型来避免这个问题。我想了解发生了什么，为什么我的值元组名称没有在响应中得到尊重？

Answer 1

正在发生的事情是 ValueTuple作为一种类型(实际上是一组泛型类型)实际上是非常静态的，并且具有名为 Item1、Item2 等的属性。

您从 C# 中获得的漂亮语法，您可以在其中声明一个名称并在代码的其他地方使用它，这只是 C# 语言的一项功能。通过名称引用这些值的编译代码最终会调用这些静态属性(例如 Item1)。事实上，您仍然可以在自己的 C# 代码中通过“项目”名称访问这些属性。

从编译代码的角度来看，关于这些元组字段名称的唯一线索是与方法相关联的属性，因此除非 ASP.NET 传递有关操作方法的上下文信息进入序列化程序，序列化程序将无法知道这些属性应该具有什么名称。

参见 this article深入了解 ValueTuples 在幕后做了什么。