问题描述

在查看.NET代码的时候，发现一个静态方法，第一个参数使用 this 关键字，它在这里是什么作用呢？

public static XElement AquireElement(this XContainer container,
        string name, bool addFirst = false)
    {
      ...

问题解答

通过查看微软的官方博文介绍(https://asp-blogs.azurewebsites.net/scottgu/new-orcas-language-feature-extension-methods), 这是C#的功能：扩展方法。

扩展方法允许开发人员向现有 CLR 类型的公共协定添加新方法，而无需对其进行子类化或重新编译原始类型。  

扩展方法有助于将当今动态语言中流行的“鸭子类型”支持的灵活性与强类型语言的性能和编译时验证相结合。

利用新的扩展方法功能向各个类型添加方法，为开发人员提供了许多有用的可扩展性场景。  然而，扩展方法真正强大的原因在于它们不仅能够应用于单个类型，而且还能够应用于 .NET中的任何父基类或接口。

这使得开发人员能够构建各种丰富的、可组合的框架扩展，这些扩展可以在 .NET 中使用。

例如：

public static int Foo(this MyClass arg)

就可以用

MyClass myClass = new MyClass();

int i = myClass.Foo();

代替传统的写法

MyClass myClass = new MyClass();

int i = Foo(myClass);

如果MyClass类是同一个项目里面的类，那么此方法优势不明显。 但是如果 MyClass类是由其它第三方开发，然后只是在自己的项目中引用。

那么，扩展方法(this)就非常强大。

本文中遇见的就是对System.Xml.Linq基类中的XContainer对象进行了扩展。添加了获取一个指定元素的扩展方法AquireElement，如元素不存在，则创建。

public static class XmlLinqExtensions
    {
        public static XElement AquireElement(this XContainer container,
            string name, bool addFirst = false)
        {
            var element = container.Element(name);
            if (null != element)
            {
                return element;
            }
            element = new XElement(name);
            if (addFirst)
            {
                container.AddFirst(element);
            }
            else
            {
                container.Add(element);
            }
            return element;
        }
    }

使用时

//XDocument document;

var configElement = document.AquireElement("configuration", addFirst: true);

var configSections = configElement.AquireElement("configSections", addFirst: true);

PS: 原生类中并没有包含AquireElement方法。

参考资料

Extension Methods ：https://asp-blogs.azurewebsites.net/scottgu/new-orcas-language-feature-extension-methods

Use of "this" keyword in formal parameters for static methods in C# : https://stackoverflow.com/questions/846766/use-of-this-keyword-in-formal-parameters-for-static-methods-in-c-sharp