C#常用的参数修饰符

1.out、ref修饰符

均允许按引用传递参数，换言之就是对形参执行的任何操作都是对实参执行的。

无论方法参数是值类型还是引用类型，均可由 ref 修改。若要使用 ref 参数，方法定义和调用方法均必须显式使用 ref 关键字，传递到 ref 或 in 形参的实参必须先经过初始化，然后才能传递。

out 形参在传递之前不需要显示初始化该形参的实参， out 形参的定义方法内必须对该形参执行赋值操作，否则会提示控制离开当前方法之前必须对 out 参数XXX赋值， ref 形参的定义方法没有必要对该形参执行赋值操作。

类的成员不能具有仅在 ref、in 或 out 方面不同的签名。如果类型的两个成员之间的唯一区别在于其中一个具有 ref 参数，而另一个具有 out 或 in 参数，则会发生编译器错误。 例如，以下代码将不会编译。

class Example
{
    public void SampleMethod(out int i){}
    //不能定义仅在参数修饰符 "ref" 和 "out" 上存在区别的重载方法
    public void SampleMethod(ref int i){}
}

但是，当一个方法具有 ref、in 或 out 参数，另一个方法具有值传递的参数时，则可以重载方法，如下面的示例所示

class Example
{
    //可以正常重载方法
    public void SampleMethod(int i){}
    public void SampleMethod(out int i){}
}

在其他要求签名匹配的情况下（如隐藏或重写），in、ref 和 out 是签名的一部分，相互之间不匹配。

属性不是变量。 它们是方法，不能传递到 ref 参数。

不能将 ref、in 和 out 关键字用于以下几种方法：

• 异步方法，通过使用 async 修饰符定义。
• 迭代器方法，包括 yield return 或 yield break 语句。

扩展方法还限制了对以下这些关键字的使用：

• 不能对扩展方法的第一个参数使用 out 关键字。
• 当参数不是结构或是不被约束为结构的泛型类型时，不能对扩展方法的第一个参数使用 ref 关键字。
• 除非第一个参数是结构，否则不能使用 in 关键字。 即使约束为结构，也不能对任何泛型类型使用 in 关键字。

2.in修饰符

允许按引用而不是按值向方法传递参数，但在 in 形参定义方法中不能对 in 形参执行赋值操作，保证安全性并节省不必要的资源浪费

3.params修饰符

把可变数量的参数(相同类型)作为单个逻辑参数传给方法，支持传入数组及多个参数一起传入

namespace ConsoleApp01
{
    class Program
    {
        static void Main(string[] args)
        {
        	Student student = new Student();
            int a, b;//传递到out形参的实参不需要显示初始化
            student.Initialize(out a, out b);
            //after of a, b: 3, 4
            Console.WriteLine($"after of a, b: {a}, {b}");

            string s1 = "oop", s2 = "orm";//传递到ref形参的实参必须显示初始化
            //before of s1, s2: oop, orm
            Console.WriteLine($"before of s1, s2: {s1}, {s2}");
            student.InitializeReference(ref s1, ref s2);
            //after of s1, s2: lihua, liming
            Console.WriteLine($"after of s1, s2: {s1}, {s2}");

            int a1 = 3, b1 = 3;//传递到in形参的实参必须显示初始化
            //a1 + b1 = 6
            Console.WriteLine("a1 + b1 = {0}", student.InitializeReadOnly(in a1, in b1));

            //传到params形参的实参可以是多个参数也可以是数组
            double avg1 = student.CalculateAverage(1.1, 2.2, 3.3, 4.4, 5.5);
            double avg2 = student.CalculateAverage(1.1, 2.2, 3.3);
            double avg3 = student.CalculateAverage(new double[] { 2.2, 4.4, 6.6 });
            //average of data: 3.3
            Console.WriteLine($"average of data: {avg1}");
            //average of data: 2.2
            Console.WriteLine($"average of data: {avg2}");
            //average of data: 4.4
            Console.WriteLine($"average of data: {avg3}");

            Console.ReadKey();
        }
    }
    public class Student
    {
        public void Initialize(out int m, out int n)
        {
            //控制离开当前方法之前必须对 out 参数 "m"、"n" 赋值
            m = 3;
            n = 4;
        }

        public void InitializeReference(ref string s1, ref string s2)
        {
            s1 = "lihua";
            s2 = "liming";
        }
        
        public int InitializeReadOnly(in int a, in int b)
        {
            //a，b是只读变量，不能修改他们的值
            return a + b;
        }
        
        public double CalculateAverage(params double[] values)
        {
            double sum = 0;
            if (values.Length == 0)
                return sum;
            for (int i = 0; i < values.Length; i++)
            {
                sum += values[i];
            }
            return sum / values.Length;
        }
    }
}