.NET 4.8.1中调用s1.Equals(s2,true)为何报object.Equals访问错误？

问题代码 #

using System;
namespace My.Namespace
{
    public static class MyExtensions
    {
        public static bool EqualsIgnoreCase(this string s1, string s2)
        {
            return s1.Equals(s2, true);
        }
        public static bool Equals(this string s1, string s2,
                                  bool ignoreCase)
        {
            StringComparison sc = ignoreCase ?
                StringComparison.OrdinalIgnoreCase :
                StringComparison.Ordinal;
            return string.Compare(s1, s2, sc) == 0;
        }
    }
    public static class Program
    {
        public static void Main()
        {
            string s1 = "abc";
            string s2 = "ABC";
            bool result = s1.Equals(s2, true);
            Console.WriteLine(result);
        }
    }
}

.NET 4.8.1编译错误信息 #

Member 'object.Equals(object, object)' cannot be accessed with
an instance reference; qualify it with a type name instead.

差异原因解析 #

.NET Framework 4.8.1的方法解析逻辑 #

.NET Framework 4.8.1的编译器在处理方法调用时，会优先匹配可兼容的已存在方法签名：

• object类有静态方法Equals(object, object)，当调用s1.Equals(s2, true)时，编译器会尝试将参数s2（string）和true（bool）隐式转换为object，认为你试图通过实例调用这个静态方法——但语法上不允许通过实例访问静态方法，因此抛出错误。
• 此时编译器不会优先查找匹配的扩展方法，因为它先识别出了一个“看似兼容”的静态方法调用形式，即使这种调用本身违反语法规则。

.NET Core/.NET 5+的方法解析优化 #

在.NET Core及后续版本中，编译器优化了方法解析逻辑：

• 会先判断实例调用的语法合法性：如果发现尝试通过实例访问静态方法，直接排除这种无效匹配。
• 随后会优先查找签名完全匹配的扩展方法，确保你的自定义Equals扩展方法能被正确识别并绑定。

.NET 4.8.1下的临时解决办法 #

• 直接通过静态类调用扩展方法：MyExtensions.Equals(s1, s2, true)
• 重命名扩展方法，避免与Equals重名（比如改为EqualsOrdinalIgnoreCase）

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