服务器之家:专注于VPS、云服务器配置技术及软件下载分享
分类导航

PHP教程|ASP.NET教程|Java教程|ASP教程|编程技术|正则表达式|C/C++|IOS|C#|Swift|Android|VB|R语言|JavaScript|易语言|vb.net|

服务器之家 - 编程语言 - C# - C# 扩展方法小结

C# 扩展方法小结

2022-10-07 15:48彭泽0902 C#

这篇文章主要介绍了C#的扩展方法的相关资料,文中讲解非常细致,帮助大家更好的理解和学习,感兴趣的朋友可以了解下

    在使用面向对象的语言进行项目开发的过程中,较多的会使用到“继承”的特性,但是并非所有的场景都适合使用“继承”特性,在设计模式的一些基本原则中也有较多的提到。

    继承的有关特性的使用所带来的问题:对象的继承关系实在编译时就定义好了,所以无法在运行时改变从父类继承的实现。子类的实现与它父类有非常紧密的依赖关系,以至于父类实现中的任何变化必然会导致子类发生变化。当你需要复用子类时,如果继承下来的实现不适合解决新的问题,则父类必须重写它或被其他更适合的类替换,这种依赖关系限制了灵活性并最终限制了复用性。替代继承特性的方式,较多的会采用 合成/聚合复用原则,“合成/聚合复用原则”:尽量使用合成/聚合,尽量不要使用类继承。

    如果在新类型的对象应当携带有关额外行为的细节,在使用继承特性时,有时可能不太适合,例如:处理指类型,密封类,或者接口时。在面对这些要求时,我们有时候会写一些静态类包含一些静态方法。但是过多的静态方法会造成额外的不必要的开销。

一.扩展方法概述:

    面对以上的有关“继承”的问题,以及在面对项目的一些需求时,我们需要解决这些问题的方式就是“扩展方法”。在C#3.0中引入了“扩展方法”,既有静态方法的优点,又使调用它们的代码的可读性得到了提高。在使用扩展方法时,可以像调用实例方法那样调用静态方法。

   1.扩展方法的基本原则:

      (1).C#只支持扩展方法,不支持扩展属性、扩展事件、扩展操作符等。

      (2).扩展方法(第一个参数前面是this的方法)必须在非泛型的静态类中声明,扩展方法必须有一个参数,而且只有第一个参数使用this标记。

      (3).C#编译器查找静态类中的扩展方法时,要求这些静态类本身必须具有文件作用域。

      (4).C#编译要求“导入”扩展方法。(静态方法可以任意命名,C#编译器在寻找方法时,需要花费时间进行查找,需要检查文件作用域中的所有的静态类,并扫描它们的所有静态方法来查找一个匹配)

      (5).多个静态类可以定义相同的扩展方法。

      (6).用一个扩展方法扩展一个类型时,同时也扩展了派生类型。

   2.扩展方法声明:

     (1).必须在一个非嵌套的、非泛型的静态类中(所以必须是一个静态方法)

     (2).至少有一个参数。

     (3).第一个参数必须附加this关键字做前缀。

     (4).第一个参数不能有其他任何修饰符(如ref或out)。

     (5).第一个参数的类型不能是指针类型。

以上的两个分类说明中,对扩展方法的基本特性和声明方式做了一个简单的介绍,有关扩展方法的使用方式,会在后面的代码样例中进行展示,再次就不再多做说明。

二.扩展方法原理解析:

 “扩展方法”是C#独有的一种方法,在扩展方法中会使用ExtensionAttribute这个attribute。

    C#一旦使用this关键字标记了某个静态方法的第一个参数,编译器就会在内部向该方法应用一个定制的attribute,这个attribute会在最终生成的文件的元数据中持久性的存储下来,此属性在System.Core dll程序集中。

    任何静态类只要包含了至少一个扩展方法,它的元数据中也会应用这个attribute,任何一个程序集包含了至少一个符合上述特点的静态类,它的元数据也会应用这个attribute。如果代码用了一个不存在的实例方法,编译器会快速的扫描引用的所有程序集,判断它们哪些包含了扩展方法,然后,在这个程序集中,可以扫描包含了扩展方法的静态类。

    如果同一个命名空间中的两个类含有扩展类型相同的方法,就没有办法做到只用其中一个类中的扩展方法。为了通过类型的简单名称(没有命名空间前缀)来使用类型,可以导入该类型所有在的命名空间,但这样做的时候,你没有办法阻止那个命名空间中的扩展方法也被导入进来。

三..NET3.5的扩展方法Enumerable和Queryable:

   在框架中,扩展方法最大的用途就是为LINQ服务,框架提供了辅助的扩展方法,位于System.Linq命名空间下的Enumerable和Queryable类。Enumerable大多数扩展是IEnumerable<T>,Queryable大多数扩展是IQueryable<T>。

   1.Enumerable类中的常用方法:

      (1).Range():一个参数是起始数,一个是要生成的结果数。

?
1
2
3
4
5
6
7
8
9
public static IEnumerable<int> Range(int start, int count) {
      long max = ((long)start) + count - 1;
      if (count < 0 || max > Int32.MaxValue) throw Error.ArgumentOutOfRange("count");
      return RangeIterator(start, count);
    }
 
    static IEnumerable<int> RangeIterator(int start, int count) {
      for (int i = 0; i < count; i++) yield return start + i;
    }

     (2).Where():对集合进行过滤的一个方式,接受一个谓词,并将其应用于原始集合中的每个元素。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
public static IEnumerable<TSource> Where<TSource>(this IEnumerable<TSource> source, Func<TSource, bool> predicate) {
     if (source == null) throw Error.ArgumentNull("source");
     if (predicate == null) throw Error.ArgumentNull("predicate");
     if (source is Iterator<TSource>) return ((Iterator<TSource>)source).Where(predicate);
     if (source is TSource[]) return new WhereArrayIterator<TSource>((TSource[])source, predicate);
     if (source is List<TSource>) return new WhereListIterator<TSource>((List<TSource>)source, predicate);
     return new WhereEnumerableIterator<TSource>(source, predicate);
   }
 
public WhereEnumerableIterator(IEnumerable<TSource> source, Func<TSource, bool> predicate) {
       this.source = source;
       this.predicate = predicate;
     }

    以上分别介绍了Range()和Where()两个方法,该类中还主要包含select()、orderby()等等方法。

  2.Queryable类中的常用方法:

    (1).IQueryable接口:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
/// <summary>
/// 提供对未指定数据类型的特定数据源的查询进行计算的功能。
/// </summary>
/// <filterpriority>2</filterpriority>
public interface IQueryable : IEnumerable
{
 /// <summary>
 /// 获取与 <see cref="T:System.Linq.IQueryable"/> 的实例关联的表达式目录树。
 /// </summary>
 ///
 /// <returns>
 /// 与 <see cref="T:System.Linq.IQueryable"/> 的此实例关联的 <see cref="T:System.Linq.Expressions.Expression"/>。
 /// </returns>
 Expression Expression { get; }
 /// <summary>
 /// 获取在执行与 <see cref="T:System.Linq.IQueryable"/> 的此实例关联的表达式目录树时返回的元素的类型。
 /// </summary>
 ///
 /// <returns>
 /// 一个 <see cref="T:System.Type"/>,表示在执行与之关联的表达式目录树时返回的元素的类型。
 /// </returns>
 Type ElementType { get; }
 /// <summary>
 /// 获取与此数据源关联的查询提供程序。
 /// </summary>
 ///
 /// <returns>
 /// 与此数据源关联的 <see cref="T:System.Linq.IQueryProvider"/>。
 /// </returns>
 IQueryProvider Provider { get; }
}

   (2).Where():

?
1
2
3
4
5
6
7
8
9
10
11
12
public static IQueryable<TSource> Where<TSource>(this IQueryable<TSource> source, Expression<Func<TSource, bool>> predicate) {
     if (source == null)
       throw Error.ArgumentNull("source");
     if (predicate == null)
       throw Error.ArgumentNull("predicate");
     return source.Provider.CreateQuery<TSource>(
       Expression.Call(
         null,
         ((MethodInfo)MethodBase.GetCurrentMethod()).MakeGenericMethod(typeof(TSource)),
         new Expression[] { source.Expression, Expression.Quote(predicate) }
         ));
   }

   (3).Select():

?
1
2
3
4
5
6
7
8
9
10
11
12
public static IQueryable<TResult> Select<TSource,TResult>(this IQueryable<TSource> source, Expression<Func<TSource, TResult>> selector) {
     if (source == null)
       throw Error.ArgumentNull("source");
     if (selector == null)
       throw Error.ArgumentNull("selector");
     return source.Provider.CreateQuery<TResult>(
       Expression.Call(
         null,
         ((MethodInfo)MethodBase.GetCurrentMethod()).MakeGenericMethod(typeof(TSource), typeof(TResult)),
         new Expression[] { source.Expression, Expression.Quote(selector) }
         ));
   }

   以上是对扩展方法中两个类进行了一个简单的解析。

四.扩展方法实例:

      由于扩展方法实际是对一个静态方法的调用,所以CLR不会生成代码对调用方法的表达式的值进行null值检查

   1.异常处理代码:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
/// <summary>
/// 为参数验证提供有用的方法
/// </summary>
public static class ArgumentValidator
{
  /// <summary>
  /// 如果argumentToValidate为空,则抛出一个ArgumentNullException异常
  /// </summary>
  public static void ThrowIfNull(object argumentToValidate, string argumentName)
  {
    if (null == argumentName)
    {
      throw new ArgumentNullException("argumentName");
    }
 
    if (null == argumentToValidate)
    {
      throw new ArgumentNullException(argumentName);
    }
  }
 
  /// <summary>
  /// 如果argumentToValidate为空,则抛出一个ArgumentException异常
  /// </summary>
  public static void ThrowIfNullOrEmpty(string argumentToValidate, string argumentName)
  {
    ThrowIfNull(argumentToValidate, argumentName);
 
    if (argumentToValidate == string.Empty)
    {
      throw new ArgumentException(argumentName);
    }
  }
 
  /// <summary>
  /// 如果condition为真,则抛出ArgumentException异常
  /// </summary>
  /// <param name="condition"></param>
  /// <param name="msg"></param>
  public static void ThrowIfTrue(bool condition, string msg)
  {
    ThrowIfNullOrEmpty(msg, "msg");
 
    if (condition)
    {
      throw new ArgumentException(msg);
    }
  }
 
  /// <summary>
  /// 如果指定目录存在该文件则抛出FileNotFoundException异常
  /// </summary>
  /// <param name="fileSytemObject"></param>
  /// <param name="argumentName"></param>
  public static void ThrowIfDoesNotExist(FileSystemInfo fileSytemObject, String argumentName)
  {
    ThrowIfNull(fileSytemObject, "fileSytemObject");
    ThrowIfNullOrEmpty(argumentName, "argumentName");
 
    if (!fileSytemObject.Exists)
    {
      throw new FileNotFoundException("'{0}' not found".Fi(fileSytemObject.FullName));
    }
  }
 
  public static string Fi(this string format, params object[] args)
  {
    return FormatInvariant(format, args);
  }
 
  /// <summary>
  /// 格式化字符串和使用<see cref="CultureInfo.InvariantCulture">不变的文化</see>.
  /// </summary>
  /// <remarks>
  /// <para>这应该是用于显示给用户的任何字符串时使用的“B”>“B”>“”。它意味着日志
  ///消息,异常消息,和其他类型的信息,不使其进入用户界面,或不会
  ///无论如何,对用户都有意义;).</para>
  /// </remarks>
  public static string FormatInvariant(this string format, params object[] args)
  {
    ThrowIfNull(format, "format");
 
    return 0 == args.Length ? format : string.Format(CultureInfo.InvariantCulture, format, args);
  }
 
  /// <summary>
  /// 如果时间不为DateTimeKind.Utc,则抛出ArgumentException异常
  /// </summary>
  /// <param name="argumentToValidate"></param>
  /// <param name="argumentName"></param>
  public static void ThrowIfNotUtc(DateTime argumentToValidate, String argumentName)
  {
    ThrowIfNullOrEmpty(argumentName, "argumentName");
 
    if (argumentToValidate.Kind != DateTimeKind.Utc)
    {
      throw new ArgumentException("You must pass an UTC DateTime value", argumentName);
    }
  }
}

  2.枚举扩展方法:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
public static class EnumExtensions
 {
   /// <summary>
   /// 获取名字
   /// </summary>
   /// <param name="e"></param>
   /// <returns></returns>
   public static string GetName(this Enum e)
   {
     return Enum.GetName(e.GetType(), e);
   }
 
   /// <summary>
   /// 获取名字和值
   /// </summary>
   /// <param name="enumType">枚举</param>
   /// <param name="lowerFirstLetter">是否转化为小写</param>
   /// <returns></returns>
   public static Dictionary<string, int> GetNamesAndValues( this Type enumType, bool lowerFirstLetter)
   {
     //由于扩展方法实际是对一个静态方法的调用,所以CLR不会生成代码对调用方法的表达式的值进行null值检查
     ArgumentValidator.ThrowIfNull(enumType, "enumType");
     //获取枚举名称数组
     var names = Enum.GetNames(enumType);
     //获取枚举值数组
     var values = Enum.GetValues(enumType);
 
     var d = new Dictionary<string, int>(names.Length);
 
     for (var i = 0; i < names.Length; i++)
     {
       var name = lowerFirstLetter ? names[i].LowerFirstLetter() : names[i];
       d[name] = Convert.ToInt32(values.GetValue(i));
     }
 
     return d;
   }
 
   /// <summary>
   /// 转换为小写
   /// </summary>
   /// <param name="s"></param>
   /// <returns></returns>
   public static string LowerFirstLetter(this string s)
   {
     ArgumentValidator.ThrowIfNull(s, "s");
 
     return char.ToLowerInvariant(s[0]) + s.Substring(1);
   }
 }

五.总结:

    在本文中,主要对扩展方法进行了一些规则说明、声明方式,使用方式,以及对扩展方法的意义和扩展方法的原理进行了简单的解答。并在本文的最后给了一个枚举的扩展方法代码。

以上就是C# 扩展方法小结的详细内容,更多关于C# 扩展方法的资料请关注服务器之家其它相关文章!

原文链接:https://cloud.tencent.com/developer/article/1013283

延伸 · 阅读

精彩推荐
  • C#C#简单判断字符编码的方法

    C#简单判断字符编码的方法

    这篇文章主要介绍了C#简单判断字符编码的方法,可实现判断utf-8,unicode,ansi等编码的功能,简单实用,需要的朋友可以参考下...

    吕秀才10002021-11-25
  • C#C#实现的滚动网页截图功能示例

    C#实现的滚动网页截图功能示例

    这篇文章主要介绍了C#实现的滚动网页截图功能,结合具体实例形式分析了C#图形操作的相关技巧,需要的朋友可以参考下...

    a7719485245392022-01-12
  • C#C# XML字符串包含特殊字符的处理转换方法小结

    C# XML字符串包含特殊字符的处理转换方法小结

    今天用C#输出XML文件时,发现报错,经过反复检查调试,发现是因为某处内容含有某些特殊字符,这些特殊字符是在XML里不被允许的...

    webkaka6072022-09-21
  • C#详解C#之委托

    详解C#之委托

    这篇文章主要介绍了C#委托的含义以及用法,文中代码非常详细,帮助大家更好的理解和学习...

    千金不如一默3432022-09-09
  • C#C#中变量、常量、枚举、预处理器指令知多少

    C#中变量、常量、枚举、预处理器指令知多少

    这篇文章主要介绍了c#共有其中变量类型有:静态变量、实类变量、数组元素、数值参数、引用参数、输出参数和局部变量,需要的朋友可以参考一下...

    Simen.Net4442021-12-31
  • C#C#控件Picturebox实现鼠标拖拽功能

    C#控件Picturebox实现鼠标拖拽功能

    这篇文章主要为大家详细介绍了C#控件Picturebox实现鼠标拖拽功能,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...

    Tomorrow Never Comes4182022-03-01
  • C#C#配置文件操作类分享

    C#配置文件操作类分享

    这篇文章主要分享了C#配置文件操作类,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...

    孤者自清6752022-01-11
  • C#C#统计字符串的方法

    C#统计字符串的方法

    这篇文章主要为大家详细介绍了C#统计字符串的方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...

    茗香淡然4612022-07-16