DDWiki/实践/后端/C#基础/28.C#中扩展方法.md

# 扩展方法
- 最常见的是在LINQ中使用扩展方法。

> 概念
- 扩展方法是一种特殊类型的静态方法。对于一个C#类型，如类（包括密封类）、值类型、接口等，扩展方法可以在不改变类型源码的前提下，为它的实例提供新的成员。

> 如何定义
- 创建扩展方法很简单，有以下步骤
   - 创建一个静态类；
   - 在其中创建一个静态方法；
   - 为这个静态方法添加至少一个参数，并在第一个参数前加上this关键字，这个关键字会告诉编译器当前方法是一个扩展方法。而这个方法将成为第一个参数所属类型的新成员。

- 如例，下面的扩展方法，用于枚举值提供一个可获取其DescriptionAttribute特性值的方法：
```
namespace TLA.Infrastructure.Extensions
{
    public static class EnumExtensions
{
    public static string GetDescription(this Enum en)
    {
        Type type=en.GetType();
        MemberInfo[] memInfo=type.GetMember(en.ToString());
        if(memInfo!=null&&memInfo.Length>0)
        {
            object[] attrs=memInfo[0].GetCustomAttributes(typeof(DescriptionAttribute),false);
            if(attrs ！=null && attrs.Length>0)
            {
                return((DescriptionAttribute)attrs[0]).Description;
            }
            return en.ToString();
        }
    }
}
}

```
- 注意：只有在引用扩展方法所在的静态类的命名空间后，才能使用扩展方法，否则，直接调用会编译失败。在上例中，使用该扩展方法要引用TLA.Infrastructure.Extensions命名空间。


> 如何使用
- 扩展方法可以用在以下几种场合：
    - 要为某个类型扩展功能，但没有其源码，比如某个款哪个家或第三方库中的一个类；例如，想要获取一个列表中的所有的奇数项，就可以为IList<T>接口增加一个扩展方法，这里的IList<T>接口本身是.NET框架中的接口。

```
public static class IListExtentions
{
    public static IEnumerable<T> OddItems<T>(this IEnumerable<T> list)
    {
        if(list==null)
        {
            throw new ArgumentNullException(nameof(list));
        }
        for (int i=0;i<list.Count();i++>)
        {
            if(i%2==0)
            {
                yield return list.ElementAt(i);
            }
        }
    }
}
```
- 即使可以访问原有类型的源码，也可以使用扩展方法为它添加辅助功能；
```
public interface ILog
{
    void Log(string message,LogLevel logLevel);
}
public static class ILogExtensions
{
    public static void LogDebug(this ILog logger,string message)
    {
        if(true)
        {
            logger?.Log($"{message}",LogLevel.Debug);
        }
    }
}
```
- 重用代码，使代码更简洁；由于扩展方法封装了一段完整的逻辑，所以，使用扩展方法就避免了复制粘贴代码的情况。上例中扩展方法的内容也符合这种使用的场景。

> 注意事项
- 扩展方法的本质是为原有类型提供辅助功能，因此，在创建时，要确保它具有实际意义，且遵循单一职责原则；也即，不能过度使用扩展方法并且它能够完成一个具体、完整的功能；
- 扩展方法本身具有通用性，因此，它里面应避免特定的业务数据类型及其相关逻辑；
- 如果为接口增加扩展方法，扩展方法的命名空间可以与接口一致；否则，应尽量避免与原类型写在同一个命名空间下，这样会“污染”原类型。建议做法是为扩展方法所在的类设定一个单独的命名空间，如：<Company>.<Product>.Extentions。不过，这样做也有缺点；在操作原有类型的实例时，如果不引用扩展方法所在的命名空间，那么，它就不容易被发现，而解决这个问题的方法是，尽量将扩展方法文档化，并告诉项目组的其他开发人员
- 为接口增加扩展方法后，则所有实现此接口的类都会包含该扩展方法；
- 在扩展方法中，要对第一个参数进行非空检查，如果为空，应抛出ArgumentNullException异常。


> 总结
- 声明扩展方法的必须条件
    - 方法必须定义在顶级的静态中，并且该静态类必须直接处在命名空间下而且不能为泛型类(即方法必须放在非嵌套、非泛型的静态中)
    - 方法必须是静态的并且第一个参数用this关键字修饰，这个参数被叫做【参数实例】
    - 方法的访问修饰符必须是public
    - 至少有一个参数
    - 不能有其他参数修饰第一个参数（如ref，out）
    - 第一个参数的类型不能是指针类型

- 注意事项
    - 实例方法优于扩展方法执行（允许有同名的实例方法和扩展方法）
    - 在空引用上可以调用扩展方法。
    - 扩展方法能够被继承

- 扩展方法相关原理
    - 其本质是静态方法
    - this关键字的作用：（1）指向当前扩展方法中第一个参数类型的实例（2）作为标记此方法为扩展方法
    - 查找扩展方法：如果对象的实例中有该实例方法，调用它的实例方法，如果未找到此时再去找扩展方法，问题是我们只知道通过this来标识为扩展方法，这个时候就得看我们的约定了，只需要到静态类去找再去静态方法去找标识为this关键字的方法，这时找到了就说明这个方法是扩展方法。