C# 參考之方法參數關鍵字：params、ref及out

如果在爲方法聲明參數時未使用 ref 或 out，則該參數可以具有關聯的值。可以在方法中更改該值，但當控制傳遞迴調用過程時，不會保留更改的值。通過使用方法參數關鍵字，可以更改這種行爲。

params

params 關鍵字可以指定在參數數目可變處採用參數的方法參數。

1. 在方法聲明中的 params 關鍵字之後不允許任何其他參數，並且在方法聲明中只允許一個 params 關鍵字。

示例：

字面意思比較難懂，所以看示例很有用。

// keywords_params.cs

using System;

class App
{
    public static void UseParams(params object[] list)
    {
        for (int i = 0; i < list.Length; i++)
        {
            Console.WriteLine(list[i]);
        }
    }

    static void Main()
    {
        // 一般做法是先構造一個對象數組，然後將此數組作爲方法的參數
        object[] arr = new object[3] { 100, 'a', "keywords" };
        UseParams(arr);

        // 而使用了params修飾方法參數後，我們可以直接使用一組對象作爲參數
        // 當然這組參數需要符合調用的方法對參數的要求
        UseParams(100, 'a', "keywords");

        Console.Read();
    }
}

ref

ref 關鍵字使參數按引用傳遞。其效果是，當控制權傳遞迴調用方法時，在方法中對參數所做的任何更改都將反映在該變量中。

1. 若要使用 ref 參數，則方法定義和調用方法都必須顯式使用 ref 關鍵字。
2. 傳遞到 ref 參數的參數必須最先初始化。這與 out 不同，out 的參數在傳遞之前不需要顯式初始化。
3. 屬性不是變量，因此不能作爲 ref 參數傳遞。
4. 儘管 ref 和 out 在運行時的處理方式不同，但它們在編譯時的處理方式是相同的。因此，如果一個方法採用 ref 參數，而另一個方法採用 out 參數，則無法重載這兩個方法。例如，從編譯的角度來看，以下代碼中的兩個方法是完全相同的。如果嘗試這麼做，將導致不能編譯該代碼。
5. 如果一個方法採用 ref 或 out 參數，而另一個方法不採用這兩類參數，則可以進行重載。

示例：

按引用傳遞值類型是有用的，但是 ref 對於傳遞引用類型也是很有用的。這允許被調用的方法修改該引用所引用的對象，因爲引用本身是按引用來傳遞的。

// keywords_ref.cs

using System;

class App
{
    public static void UseRef(ref int i)
    {
        i += 100;
        Console.WriteLine("i = {0}", i);
    }

    static void Main()
    {
        int i = 10;

        // 查看調用方法之前的值
        Console.WriteLine("Before the method calling: i = {0}", i);

        UseRef(ref i);

        // 查看調用方法之後的值
        Console.WriteLine("After the method calling: i = {0}", i);
        Console.Read();
    }
}

/**//*
控制檯輸出：
Before the method calling : i = 10
i = 110
After the method calling: i = 110
*/

out

out 關鍵字會導致參數通過引用來傳遞。這與 ref 關鍵字類似。

與 ref 的不同之處：

1. ref 要求變量必須在傳遞之前進行初始化。
2. 儘管作爲 out 參數傳遞的變量不需要在傳遞之前進行初始化，但需要調用方法以便在方法返回之前賦值。

示例：

與 ref 示例不同的地方只要將 ref 改爲 out，然後變量 i 僅需要聲明即可。

static void Main()
{
    //int i = 10; 改爲
    int i;
    //
}