C#扩展方法编译报错 仅可作为静态方法访问无法以扩展语法调用

问题相关代码 #

你声明的字符串扩展方法代码如下：

namespace ExtensionMethods
{
    public static class MyExtensions
    {
        const string Nil = "$$$NIL$$$";
        public static bool IsEmptyNullOrNil(this string str)
        {
            if (string.IsNullOrEmpty(str) || str == Nil)
            {
                return true;
            }
            return false;
        }
    }
}

问题现象 #

• 控制器类中已经引入了扩展方法所在的ExtensionMethods命名空间
• 程序无法通过编译
• 仅支持将该方法作为普通静态方法调用，无法通过字符串实例直接使用扩展方法语法调用
• 报错截图：
  

排查&解决方案 #

按优先级从高到低依次排查：

• 校验C#语言版本与目标框架版本
  扩展方法是C# 3.0版本引入的语法特性，要求项目配置的C#语言版本≥3.0，目标框架至少为.NET Framework 3.5、.NET Core 1.0及以上版本。如果项目配置了过低的语言版本或框架版本，编译器不会识别参数前的this关键字为扩展方法标记，只会将方法识别为普通静态方法。
• 确认跨项目/程序集引用有效
  如果扩展方法定义在与控制器不同的独立项目/程序集中，需要确认控制器所在项目已经添加了对扩展方法所在项目的正确项目引用或程序集引用，仅在代码顶部编写using命名空间指令、缺少有效程序集引用时，扩展方法不会被编译器识别。
• 排除同名方法冲突
  检查当前控制器类、控制器继承的基类、以及其他已引入命名空间中，是否存在同名的IsEmptyNullOrNil方法，是否存在同签名的string类型扩展方法，导致编译器匹配时出现歧义，无法正确解析目标扩展方法。
• 清理编译缓存后重新生成
  关闭开发IDE后删除项目根目录下的bin、obj缓存文件夹，重新打开解决方案执行全量重新生成，排除历史编译缓存导致的语法识别异常。
• 校验扩展方法定义合规性
  扩展方法必须定义在非嵌套、非泛型的静态类中，方法本身必须为公有的静态方法，你当前的写法符合该规则，该项基本可以排除问题。

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