C#的扩展方法详解

Archy_Wang

已于 2024-08-15 14:59:49 修改

阅读量2.5w

点赞数 12

分类专栏： C#基础文章标签： c# java 数据库

于 2018-07-06 10:03:55 首次发布

本文链接：https://blog.csdn.net/u011966339/article/details/80936675

版权

C#基础专栏收录该内容

31 篇文章

订阅专栏

扩展方法被定义为静态方法，但它们是通过实例方法语法进行调用的。它们的第一个参数指定该方法作用于哪个类型，并且该参数以 this 修饰符为前缀。扩展方法当然不能破坏面向对象封装的概念，所以只能是访问所扩展类的public成员。
扩展方法使您能够向现有类型“添加”方法，而无需创建新的派生类型、重新编译或以其他方式修改原始类型。扩展方法是一种特殊的静态方法，但可以像扩展类型上的实例方法一样进行调用。
C#扩展方法第一个参数指定该方法作用于哪个类型，并且该参数以 this 修饰符为前缀。
扩展方法的目的就是为一个现有类型添加一个方法，现有类型既可以是int，string等数据类型，也可以是自定义的数据类型。
为数据类型的添加一个方法的理解：一般来说，int数据类型有个Tostring的方法，就是把int 数据转换为字符串的类型，比如现在我们想在转换成字符串的时候还添加一点东西，比如增加一个字符 a .那么之前的Tostring就不好使了，因为它只是它我们的int数据转换为string类型的，却并不能添加一个字母 a.所以这就要用到所谓的扩展方法了。
首先我们看一个给现有的类型增加一个扩展方法。
我们想给string 类型增加一个Add方法，该方法的作用是给字符串增加一个字母a.

实例1：

//必须是静态类才可以添加扩展方法

Static class Program

{

static void Main(string[] args)

{

string str = "quzijing";

//注意调用扩展方法,必须用对象来调用

string Newstr = str.Add();

Console.WriteLine(Newstr);

Console.ReadKey();

}

//声明扩展方法

//扩展方法必须是静态的，Add有三个参数

//this 必须有，string表示我要扩展的类型，stringName表示对象名

//三个参数this和扩展的类型必不可少，对象名可以自己随意取如果需要传递参数，//再增加一个变量即可



public static string Add(this string stringName)

{

return stringName+"a";

}

}

我们再来尝试给我们自定义的类型增加一个扩展方法，并增加一个传递的参数。

实例2：

首先我们声明一个Student类，它包含了两个方法StuInfo,getStuInfo.实例代码如下：

public class Student

{

public string StuInfo()

{

return "学生基本信息";

}

public string getStuInfo(string stuName, string stuNum)

{

return string.Format("学生信息：\n" + "姓名：{0} \n" + "学号：{1}", stuName, stuNum);

}

}

之后我们再声明一个名为ExtensionStudentInfo的静态类，注意必须为静态

这个类的作用就是包含一些我们想要扩展的方法，在此我们声明两个Student类型的扩展方法，Student类型为我们自定义的类型。示例代码如下：

public static class ExtensionStudentInfo

{

//声明扩展方法

//要扩展的方法必须是静态的方法，Add有三个参数

//this 必须有，string表示我要扩展的类型，stringName表示对象名

//三个参数this和扩展的类型必不可少，对象名可以自己随意取如果需要传递参数，再增加一个变量即可

public static string ExtensionStuInfo(this Student stuName)

{

return stuName.StuInfo();

}

//声明扩展方法

//要扩展的方法必须是静态的方法，Add有三个参数

//this 必须有，string表示我要扩展的类型，stringName表示对象名

//三个参数this和扩展的类型必不可少，对象名可以自己随意取如果需要传递参数，在此我们增加了两个string类型的参数

public static string ExtensionGetStuInfo(this Student student, string stuname, string stunum)

{

return student.getStuInfo(stuname, stunum)+"\n读取完毕";

}

}

以上的工作做完之后便可以使用我们的扩展方法了，注意必须要用对象来调用扩展方法。

static void Main(string[] args)

{

Student newstudent = new Student();

//要使用对象调用我们的扩展方法

string stuinfo = newstudent.ExtensionStuInfo();

Console.WriteLine(stuinfo);

//要使用对象调用我们的扩展方法

string stuinformation = newstudent.ExtensionGetStuInfo("quzijing", "20081766");

Console.WriteLine(stuinformation);

Console.ReadKey();

}

实例3、使用TagBuilder类创建扩展方法

上面自定义的Span()方法十分简单, 但是有时候我们要构造具有复杂结构的Html元素, 如果用字符串拼接的方法就有些笨拙.

ASP.NET MVC框架提供了一个帮助我们构造Html元素的类:TagBuilder

TagBuilder类有如下方法帮助我们构建Html控件字符串:

方法名称	用途
AddCssClass()	添加class=””属性
GenerateId()	添加Id, 会将Id名称中的"."替换为IdAttributeDotReplacement 属性值的字符.默认替换成"_"
MergeAttribute()	添加一个属性,有多种重载方法.
SetInnerText()	设置标签内容, 如果标签中没有再嵌套标签,则与设置InnerHTML 属性获得的效果相同.
ToString()	输出Html标签的字符串, 带有一个参数的重载可以设置标签的输出形式为以下枚举值: TagRenderMode.Normal -- 有开始和结束标签 TagRenderMode.StartTag -- 只有开始标签 TagRenderMode.EndTag -- 只有结尾标签 TagRenderMode.SelfClosing -- 单标签形式,如<br/>

同时一个TagBuilder还有下列关键属性:

属性名称	用途
Attributes	Tag的所有属性
IdAttributeDotReplacement	添加Id时替换"."的目标字符
InnerHTML	Tag的内部HTML内容
TagName	Html标签名, TagBuilder只有带一个参数-TagName的构造函数.所以TagName是必填属性

下面在添加一个自定义的HtmlHelper类扩展方法,同样是输出一个<Span>标签:

public static string Span(this HtmlHelper helper, string id, string text, string css, object htmlAttributes)

{

//创意某一个Tag的TagBuilder

var builder = new TagBuilder("span");



//创建Id,注意要先设置IdAttributeDotReplacement属性后再执行GenerateId方法.

builder.IdAttributeDotReplacement = "-";

builder.GenerateId(id);





//添加属性

builder.MergeAttributes(new RouteValueDictionary(htmlAttributes));



//添加样式

builder.AddCssClass(css);

//或者用下面这句的形式也可以: builder.MergeAttribute("class", css);



//添加内容,以下两种方式均可

//builder.InnerHtml = text;

builder.SetInnerText(text);



//输出控件

return builder.ToString(TagRenderMode.Normal);



}

在页面上,调用这个方法:

<% =Html.Span("span.test", "使用TagBuilder帮助构建扩展方法", "ColorRed", new { style="font-size:15px;" })%>

生成的Html代码为:

<span id="span-test" class="ColorRed" style="font-size: 15px;">使用TagBuilder帮助构建扩展方法</span>

实例4

(1)、扩展方法

using System;



using System.Collections.Generic;



using System.Linq;



using System.Text;



using System.Text.RegularExpressions;







//声明扩展方法的步骤：类必须是static，方法是static，



//第一个参数是被扩展的对象，前面标注this。



//使用扩展方法的时候必须保证扩展方法类已经在当前代码中using



namespace 扩展方法



{



//扩展方法必须是静态的



public static class StringHelper



{



//扩展方法必须是静态的，第一个参数必须加上this



public static bool IsEmail(this string _input)



{



return Regex.IsMatch(_input, @"^\\w+@\\w+\\.\\w+$");



}



//带多个参数的扩展方法



//在原始字符串前后加上指定的字符



public static string Quot(this string _input, string _quot)



{



return _quot + _input + _quot;



}



}



}

(2)、使用方法

using System;



using System.Collections.Generic;



using System.Linq;



using System.Text;



namespace 扩展方法



{



class Program



{



static void Main(string[] args)



{



string _myEmail = "abc@163.com";



//这里就可以直接使用string类的扩展方法IsEmail了



Console.WriteLine(_myEmail.IsEmail());



//调用接收参数的扩展方法



Console.WriteLine(_myEmail.Quot("!"));







Console.ReadLine();



}



}



}

总结：

在我们的编程生涯中我们要使用很多很多类库，这些类库有的是我们自己开发的，我们有她的代码，有的是第三方发布的，我们不仅没有他们的代码，连看的机会都没有。

作为.net程序员，我们每天都要和BCL(Base Class Linbrary)打交道。无疑，BCL做为一个年轻的框架类库，她是成功的，但是还有一些时候我们还是得写一些”Helper”方法来扩展类库，由于我们不能修改类库的源代码，我们只有写一个个的静态类。虽然在使用上也算方便，但作为追求完美的程序员来说总有些不雅。现在我就碰到这样的事情，前两天奉命写一个从XML文件加载Chart图的设置的方法，从XML加载数据绑定到对象上，这肯定是反射的用武之地了。我经常需要写一些根据对象属性名字来判断这个对象是否有这个属性或者根据属性名获取该属性的值。还是按照平常一样，我很快写了一个PropertyHelper，里面有两个静态方法：HasProperty,GetValueByName。

PropertyHelper.HasProperty(point, "X")，如此的调用也还过得去，不过在C# 3.0微软为我们提供了扩展方法。现在我们可以直接这样调用了point.HasProperty(“X”);看看我是如何实现这个扩展方法的？

public static class PropertyExtension

{

public static object GetValueByName(this object self, string propertyName)

{

if (self == null)

{

return self ;

}

Type t = self.GetType();

PropertyInfo p = t.GetProperty(propertyName);

return p.GetValue(self, null);

}

}

我给object类型添加了一个扩展方法，在.net里所有的类都继承自object，那所有的类都默认的拥有这个方法了，真方便，呵呵。

注意到和普通的静态方法有何差别？在这个方法的第一个参数前面多了一个this关键字。

扩展方法：

1 方法所在的类必须是静态的

2 方法也必须是静态的

3 方法的第一个参数必须是你要扩展的那个类型，比如你要给int扩展一个方法，那么第一个参数就必须是int。

4 在第一个参数前面还需要有一个this关键字。

按照上面的步骤写你就得到了一个“扩展方法”，你可以像调用这个类的原生方法那样去调用它：