C#如何使用扩展方法_C#为已有类型动态添加自定义方法【核心】-C#.Net教程-PHP中文网

扩展方法本质是编译器语法糖，将s.wordcount()转换为stringextension.wordcount(s)；必须定义在非嵌套静态类中，否则报cs1106，且无法访问私有/内部成员。

c#如何使用扩展方法_c#为已有类型动态添加自定义方法【核心】

扩展方法不是“真的”加到类型上，而是编译器在调用点做的语法糖转换——它把 s.WordCount() 翻译成 StringExtension.WordCount(s)。只要满足可见性、命名空间引入和静态类约束，就能用，但别指望它能访问私有字段或绕过封装。

扩展方法必须定义在非嵌套静态类中

这是硬性限制，编译器会直接报错：CS1106: Extension method must be defined in a static class。常见错误包括：

把扩展方法写在普通类、泛型类或嵌套类（比如 class Outer { static class Inner { ... } }）里
忘了加 static 修饰符，哪怕类名带 Extensions 也不行
类用了 internal 但调用方在另一个程序集，没加 [InternalsVisibleTo]

正确写法示例：

namespace MyLib
{
    public static class StringExtensions  // 必须 public + static + 非嵌套
    {
        public static int WordCount(this string s)
        {
            return string.IsNullOrEmpty(s) ? 0 : s.Split(' ', '.', '?').Length;
        }
    }
}

调用前必须 using 对应命名空间

即使扩展方法类已引用，没 using MyLib; 就不会出现在 IntelliSense 里，编译也会失败：CS1061: 'string' does not contain a definition for 'WordCount'。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

命名空间名和类名无关，using MyLib; 才是关键，不是 using MyLib.StringExtensions;
如果多个命名空间都定义了同名扩展方法（如两个 WordCount），编译器会报歧义错误，必须显式调用静态方法来绕过
.NET SDK 项目默认不自动导入自定义命名空间，别依赖“全局 using”隐式包含

C# 14 的 extension 块语法更紧凑但要求严格

相比传统 this string s 写法，C# 14 允许用 extension(string s) 块组织多个成员，但容易漏掉细节：

块内方法不能带 this 参数，参数名必须和 extension 声明一致（如 extension(string str) → 方法里直接用 str）
块只能定义在非泛型静态类中，且一个类里只能有一个 extension 块对应一种类型
IDE 可能暂不完全支持新语法的智能提示，遇到补全失效先检查是否升级到 .NET 9+ SDK 和最新 VS / Rider

合法示例：

namespace MyLib
{
    public static class StringExtensions
    {
        extension(string s)
        {
            public int WordCount() => s.Split(' ').Length;
            public bool IsLong() => s.Length > 100;
        }
    }
}