您当前的位置: 年关将近，整个人已经没有了工作和写作的激情，估计这个时候很多人跟我差不多，该相亲的相亲，该聚会喝酒的聚会喝酒，总之就是没有了干活的心思（我有很多想法，但就是叫不动我的手脚，所以我只能看着别人在做我想做的事，吃我想吃的东西。）。本人由上个月的每周四五篇，到现在的文章缩短到每周一篇，说个实话，现在的一篇也有不想写的心思了（这一篇还是咬着牙写的，感觉实在是写不动了，写博客太折腾人了，谁写谁知道啊！），不过还是希望写出来可以帮到大家，如有写的不足的地方，还望大家多多指正，知识在于总结和反思，对别人也对自己都是一个提高。
这里先来一段废话，缓和一下气氛，免得让大家很尴尬（太直接了还是不太好，总不能见到喜欢的女生就表白吧，还得多多的相处，让人觉得你稳重有深度。），现在进入我们今天的博客内容，那就是.NET的参数用法。因为在.NET的参数用法和约束特别多，对于很多初学者来说，这样繁多的参数用户简直就是跟扯淡一样，即使对于是拥有丰富经验的开发者来说，也未必能够很轻松使用所有的参数用法和选择合适的参数类型。谈到参数，估计很多人就只是想着我们在一般的方法调用中使用的那样，如string，int，object等等类型，更多的也就没有了印象，就是知道，也就是在遇到了再去查看一下，这样其实也没错，毕竟不能话费过多的时间用在哪些不常用的知识上，但是我个人觉得对于知识还是需要提前有一个全面的学习，可能具体的细节不能很好的把握，但是对于全局的概念还是得有一个整体的学习。
下面就简单的介绍一下.NET的一些常用参数用法，如有不足还望指正，也欢迎大家在下面留言讨论，分享自己的见解。
一.DotNet参数概述：
.NET中参数（形式参数）变量是方法或索引器声明的一部分，而实参是调用方法或索引器时使用的表达式。
在CLR中，默认的情况下所有的方法参数都是传值的。在传递引用类型的对象时，对一个对象的引用会传递给方法。这里的船引用本身是以传值的方式传给方法的。这也意味着方法能够修改对象，而调用者能看到这些修改。对于值类型的实例，传给方法的实例的一个副本。意味着方法将获得它专用的一个值类型实例副本，调用者中的实例不受影响。
在CLR中允许以传引用而非传值的方式传递参数，在C#中使用out和ref来实现传递引用的方式传值。在C#中使用out和ref来实现传递引用的方式传值,这两个关键字告诉编译器生成元数据来指明该参数是传引用的，编译器将生成代码来传递参数的地址，而不是传递参数本身。为值类型使用out和ref，效果等同于以传值的方式传递引用类型。
常用的参数主要有基本类型参数，泛型参数，以及<in T>和<out T>，dynamic等等。例如<in T>和<out T>，在CLR中支持泛型类型的可变性，C#在4.0时获得了生命泛型遍体所必须的语法，并且现在编译器也能够知道接口和委托可能的转换。可变性是以一种类型安全的方式，讲一个对象作为另一个对象来使用。可变性应用于泛型接口和泛型委托的类型参数中。协变形用于向调用者返回某项操作的值；逆变性是指调用者想API传入值；不变性是相对于协变性和逆变性，是指什么也不会发生。对于这方面的知识非常的丰富，有兴趣的可以自行了解，这里就不做详细的介绍了。dynamic类型，C#是一门静态类型的语言，在某些情况下，C#编译器要寻找特定的名称而不是接口。dynamic可以在编译时做任何事，到执行时再由框架进行处理。有关动态类型的介绍也不做更深入的介绍。
在.NET中参数的使用方法主要为可选参数、命名参数、可变数量参数等等。本文下面也是主要介绍这三种参数的使用方法。
二.DotNet参数用法：
以下是主要介绍三种参数的用法：可选参数；命名实参；传递可变数量的参数。
1.可选参数：
(1).基本用法：
如果某个操作需要多个值，而有些值在每次调用的时候又往往是相同的，这时通常可以使用可选参数。在C#以前实现可变参数的功能，往往声明一个包含所有可能参数的方法，其他方法调用这个方法，并传递恰当的默认值。
在可选参数中，设计一个方法的参数时，可以为部分或全部参数分配默认值。在调用这些方法代码可以选择不指定部分实参，接受默认值。还可以在调用方法时，还可以通过指定参数名称的方式为其传递实参。如下实例：
static void OptionalParameters(int x, int y = 10, int z = 20) { Console.WriteLine("x={0} y={1} z={2}",x,y,z); } OptionalParameters(1, 2, 3); OptionalParameters(1, 2); OptionalParameters(1);
以上的例子可以很清楚的看到其用法，int y=10和int z=20这两个参数就是可选参数。可选参数的使用中，如果调用时省略了一个参数，C#编译器会自动嵌入参数的默认值。向方法传递实参时，编译器按从左向右的顺序对实参进行求值。使用已命名的参数传递实参时，编译器仍然按照从左到右的顺序对实参进行求值。
(2).基本原则：
可选参数包含一些规范，具体的一些要求如下：
(a).所有可选参数必须出现在必备参数之后，参数数组（使用params修饰符声明）除外，但他们必须出现在参数列表的最后，在他们之前是可选参数。
(b).参数数组不能声明为可选的，如果调用者没有指定值，将使用空数组代替。
(c).可选参数不能使用ref和out修饰符。
(d).可选参数可以为任何类型，但对于指定的默认值却有一些限制，那就是默认值必须为常量（数字或字符串字面量、null、const成员、枚举成员、default(T)操作符）。
(e).指定的值会隐式转换为参数类型，但是这种转换不能是用户定义的。
(f).可以为方法、构造器、有参属性的参数指定默认值，还可以为属于委托定一部分的参数指定默认值。
(g).C#不允许省略逗号之间的实参。
在使用可选参数时，对于引用类型使用null来做默认值，如果参数类型是值类型，只需要使用相应的可空值类型作为默认值。
(3).代码示例：
/// <summary> /// 提取异常及其内部异常堆栈跟踪 /// </summary> /// <param name="exception">提取的例外</param> /// <param name="lastStackTrace">最后提取的堆栈跟踪（对于递归）， String.Empty or null</param> /// <param name="exCount">提取的堆栈数（对于递归）</param> /// <returns>Syste.String</returns> public static string ExtractAllStackTrace(this Exception exception, string lastStackTrace = null, int exCount = 1) { while (true) { var ex = exception; const string entryFormat = "#{0}: {1}\r\n{2}"; lastStackTrace = lastStackTrace ?? string.Empty; lastStackTrace += string.Format(entryFormat, exCount, ex.Message, ex.StackTrace); if (exception.Data.Count > 0) { lastStackTrace += "\r\n Data: "; lastStackTrace = exception.Data.Cast<DictionaryEntry>().Aggregate(lastStackTrace, (current, entry) => current + $"\r\n\t{entry.Key}: {exception.Data[entry.Key]}"); } //递归添加内部异常 if ((ex = ex.InnerException) == null) return lastStackTrace; exception = ex; lastStackTrace = $"{lastStackTrace}\r\n\r\n"; exCount = ++exCount; } }
2.命名实参：
以上讲解了可选参数的一些基本概念和用法，接下来看一下命名参数的相关操作用法：
(1).基本用法：
命名实参是指在指定实参的值时，可以同时指定相应的参数名称。编译器将判断参数的名称是否正确，并将指定的值赋给这个参数。命名参数在各个实参之前加上它们的参数名称以及一个冒号。如下代码：
new StreamWriter(path:filename,aooend:true,encoding:realEncoding);
如果要对包含ref和out的参数指定名称，需要将ref和out修饰符放在名称之后，实参之前。
int number; bool success=int.TryParse("10",result:out number);
(2).基本原则：
在命名参数中，所有的命名参数必须位于位置实参之后，两者之间的位置不能改变。位置实参总是指向方法声明中相应的参数，不能跳过参数之后，在通过命名相应位置的实参来指定。实参仍然按编写顺序求值，即使这个顺序有可能会不同于参数的声明顺序。
在一般情况下，可选参数与命名实参会一起配合使用。可选参数会增加适用方法的数量，而命名实参会减少使用方法的数量。为了检查是否存在特定的适用方法，编译器会使用位置参数的顺序构建一个传入实参的列表，然后对命名实参和剩余的参数进行匹配。如果没有指定某个必备参数，或某个命名实参不能与剩余的参数相匹配，那么这个方法就不是适用的。
命名实参有时可以代替强制转换，来辅助编译器进行重载决策。如果方法是从模块的外部调用的，更改参数的默认值是具有潜在的危险的。可以按名称将实参传给没有默认值的参数，但是编译器要想编译代码，所有要求的实参都必须传递。
在写C#代码与COM对象模型进行互操作时，C#的可选参数和命名参数功能是最好用的，调用一个COM组件时，为了以传引用的方式传递一个实参，C#还允许省略REF/OUT，在嗲用COM组件时，C#要求必须向实参应用OUT.REF关键字。
3.传递可变数量的参数：
在项目开发中，有时我们需要定义一个方法来获取可变数量的参数。可以使用params，params只能应用于方法签名中的最后一个参数。params关键字告诉编译器向参数应用System.ParamArrayAttribute的实例。我们具体看一下实现的代码：
[AttributeUsage(AttributeTargets.Parameter, Inherited=true, AllowMultiple=false), ComVisible(true), __DynamicallyInvokable] public sealed class ParamArrayAttribute : Attribute { // Methods [__DynamicallyInvokable] public ParamArrayAttribute(); } [__DynamicallyInvokable] public ParamArrayAttribute() { }
以上的代码可以看出该类继承自Attribute类，对于Attribute类可能不会陌生，那就是定义定制属性的基类，说明ParamArrayAttribute类用于定义定制属性，ParamArrayAttribute类在System命名空间下，ParamArrayAttribute类只有一个构造方法，没有具体的实现。AttributeUsage也定义了属性的使用方式。
C#编译器检测到一个方法调用时，会检查所有具有指定名称、同时参数没有应用ParamArrayAttribute的方法。如果找到一个匹配的方法，编译器生成调用它所需的代码。如果编译器没有找到一个匹配的方法，会直接检查应用ParamArrayAttribute的方法。如果找到一个匹配的方法，编译器会先生成代码来构造一个数组，填充它的元素，再生成代码来调用选定的方法。
调用一个参数数量可变的方法时，会造成一些额外的性能损失，数组对象必须在对上分配，数组元素必须初始化，而且数组的内存最终必须垃圾回收。
提供一个方法代码，仅供参考：
/// <summary> /// 字符型二维数组转换成DataTable /// </summary> /// <param name="stringDyadicArray"></param> /// <param name="messageOut"></param> /// <param name="dataTableColumnsName"></param> /// <returns></returns> public DataTable DyadicArrayToDataTable(string[,] stringDyadicArray, out bool messageOut, params object[] dataTableColumnsName) { if (stringDyadicArray == null) { throw new ArgumentNullException("stringDyadicArray"); } var returnDataTable = new DataTable(); if (dataTableColumnsName.Length != stringDyadicArray.GetLength(1)) { messageOut = false; return returnDataTable; } for (var dataTableColumnsCount = 0;dataTableColumnsCount < dataTableColumnsName.Length;dataTableColumnsCount++) { returnDataTable.Columns.Add(dataTableColumnsName[dataTableColumnsCount].ToString()); } for (var dyadicArrayRow = 0; dyadicArrayRow < stringDyadicArray.GetLength(0); dyadicArrayRow++) { var addDataRow = returnDataTable.NewRow(); for (var dyadicArrayColumns = 0; dyadicArrayColumns < stringDyadicArray.GetLength(1);dyadicArrayColumns++) { addDataRow[dataTableColumnsName[dyadicArrayColumns].ToString()] = stringDyadicArray[dyadicArrayRow, dyadicArrayColumns]; } returnDataTable.Rows.Add(addDataRow); } messageOut = true; return returnDataTable; }
以上给出了一个使用可变参数数量以及命名参数的使用样例，完成了将二维字节数组转化为DataTable对象，将数组进行遍历，并将数组写入datatable中，对于整个方法的逻辑就不做深入介绍，代码比较的简单。
三.与参数有关的一些指导原则：
声明方法的参数类型时，应尽量指定最弱的类型，最好是接口而不是基类。
在设计模式的基本原则中，迪米特法则也较最少知识原则，迪米特法则是指如果两个类不必彼此直接通信，那么这两个类就不应当直接的相互作用。如果其中一个类需要调用另一个类的某一个方法的话，可以通过第三者转发这个调用。在类结构的设计上，每一个类都应当尽量降低成员的访问权限。类之间的耦合度越弱，越有利于复用，一个处在弱耦合的类被修改，不会对有关系的类造成波及。
对于参数的使用中，我们在对参数类型的使用上，还是需要很仔细和认真的去思考，因为在参数类型的定义上，在一定程度上影响着我们程序的扩展性和稳定性，如果参数类型的约束比较大，对于后续方法的扩展，意义是巨大的。在整个面向对象的语言体系中，一切设计模式都是由“多态”延伸而来，对于接口和委托都是在我们面向对象设计中使用很多的，目的较多的是在使用时扩大参数的约束性。
在方法的返回值类型中，返回的类型应该声明为最强的类型，以免受限于特定的类型。
四.总结：
以上是一篇简单介绍方法参数的文章，在文章内容中主要对于介绍可选参数、命名参数等。以上的内容如果有不足的地方还望大家多多包涵，也希望能够指出对应的问题。知识先于模范，后于反思。学习完一点后，需要我们去总结和反思，其中的内涵我们才会有时间和精力，以及由能力去思考。
- 4楼明珠师兄
- 有一百多个人从美国访问诶，以后写成英文博客，声名更是大噪。
- Re: 彭泽0902
- @明珠师兄，敢不敢再逗一些。。。。。
- 3楼Sinte-Beuve
- 扫盲贴
- Re: 彭泽0902
- @Sinte-Beuve，算比较少些这个的吧。。。。
- 2楼lvtu0902
- mark。。。。
- Re: 彭泽0902
- @lvtu0902，good
- 1楼qiangges2016
- 想请教下，标题栏的彩色条带怎么做的？文章排版很不错，想学习下。谢谢
- Re: 反骨仔（二五仔）
- @qiangges2016，我的都搞成绿色
- Re: 彭泽0902
- @qiangges2016，网上有其他人写过，你可以搜索一下。哈哈哈。。。。