在不破坏向后兼容性的情况下更改参数名称

Question

我正在开发一个 c# 库，因此我们担心破坏向后兼容性，但我想知道是否可以仅更改参数的名称并保持向后兼容性，因为能够使用命名参数？下面是我正在尝试做的一个示例

[Obsolete("use ChangeSpecificFoo(SpecificFoo specificFoo)")]
public void ChangeSpecificFoo(SpecificFoo foo)
{
    _specificFoo = foo;
}

//Compile error ... already defines a member called 'ChangeSpecificFoo' with the same parameter types
public void ChangeSpecificFoo(SpecificFoo specificFoo)
{
    _specificFoo = specificFoo;
}

仅更改参数名称存在破坏向后兼容性的潜在风险，因为有人可能会使用诸如 ChangeSpecificFoo(foo: someSpecificFoo) 之类的命名参数调用该方法，但我们不能通过添加具有正确参数名称的新方法来弃用该方法，因为参数名称不包含在方法签名中，因此编译器将其视为重复。

有没有办法解决这个问题？我看到的唯一替代方法是更改​​方法名称，使其不重复，然后弃用旧方法，或者等到我们从参数列表中添加或删除参数并更改参数名称（这可能永远不会发生，因为方法是非常稳定），或者只是进行更改并修复我们在使用此库的代码中可能遇到的任何中断。

Answer 1

我对此的第一个倾向很简单：不要。您的参数名称在方法主体之外是无关紧要的。您认为人们通过名称来称呼它是正确的，因此可能会破坏它。但是，仅更改参数名称并没有真正的好处。

更改名称的唯一可能原因是重新定义方法的作用，因为旧名称会导致混淆。在这种情况下，方法的名称也应该更改，以免引起其他形式的混淆。 （方法签名相同的事实是不更改参数名称的第一个也是更重要的原因。但是，这可能会解释您可能想要的原因。）

但是，如果您仍然坚持保持相同的方法签名，但更改名称，您可以这样做。 （同样，我强烈建议您要么根本不要更改它，要么重命名方法以继续消除混淆。）

解决此问题的一种方法是让该方法具有两个参数，但将第二个参数设为可选。让最后一个参数使用旧名称，然后在方法中分配它。

我还强烈建议记录命名参数的任何使用情况，以查看您对人们将其称为命名参数的担忧是否有效。

public void ChangeSpecificFoo(SpecificFoo specificFoo = null, SpecificFoo foo = null)
{
    if (foo != null && specificFoo == null)
    {
        // Add any other details you can, especially 
        // to figure out who is calling this.
        Log("Someone used a name parameter!!");
    }
    _specificFoo = specificFoo ?? foo;
}

正如Dmitry Bychenko 在 cmets 中指出的那样，这不会阻止任何人像这样调用此方法：ChangeSpecificFoo(null, new SpecificFoo())，这将触发日志记录。

他的观察介绍了为什么这是一个坏主意的另一个原因：您现在引入了另一种方式，让人们“错误地”调用您的方法。因此，我将重复我在回答顶部的建议：不要这样做，除非您真的真的需要更改该参数名称。