在 C# 程式設計中,理解方法參數的傳遞方式至關重要。預設情況下,C# 採用值傳遞,但透過 ref 與 out 關鍵字可實現引用傳遞。本文將透過完整程式碼範例,深入剖析值類型與引用類型在不同傳遞方式下的行為差異,並釐清 ref 與 out 的細微卻關鍵的區別。
ref:呼叫端必須先初始化變數;方法可讀可寫。out:呼叫端可不初始化;方法必須在返回前賦值(單向輸出)。#define Test
using System;
namespace Wrox.ProCSharp.ParameterTestSample
{
class ParameterTest
{
// 1. 預設值傳遞(陣列為引用類型,整數為值類型)
static void TestInt(int[] ints, int i)
{
ints[0] = 100; // 修改陣列元素:影響原陣列
i = 100; // 修改整數副本:不影響原變數
}
// 2. ref 引用傳遞
static void TestInt(int[] ints, ref int i)
{
ints[0] = 200;
i = 200; // 直接修改原變數
}
// 3. out 輸出參數
static void TestInt2(int[] ints, out int i)
{
ints[0] = 300;
i = 300; // 必須賦值
}
public static void Main()
{
int i = 0;
int[] ints = {0, 1, 2, 3, 4};
Console.WriteLine("-----------TestInt (值傳遞)------------------");
Console.WriteLine($"i={i}, ints[0]={ints[0]}");
TestInt(ints, i);
Console.WriteLine($"呼叫後 i={i} (不變), ints[0]={ints[0]} (變為 100)");
Console.WriteLine("\n-----------TestInt (ref)------------------");
TestInt(ints, ref i);
Console.WriteLine($"呼叫後 i={i} (變為 200), ints[0]={ints[0]} (變為 200)");
Console.WriteLine("\n-----------TestInt2 (out)------------------");
TestInt2(ints, out i);
Console.WriteLine($"呼叫後 i={i} (變為 300), ints[0]={ints[0]} (變為 300)");
// ref vs out 關鍵差異示範
Console.WriteLine("\n--- ref 需初始化,out 不需 ---");
#if Test
int j;
// TestInt(ints, ref j); // 編譯錯誤:使用未賦值的區域變數 'j'
#endif
int k;
TestInt2(ints, out k); // 合法:out 不要求預先初始化
Console.WriteLine($"k={k} (out 參數成功接收值)");
Console.ReadLine();
}
}
}
-----------TestInt (值傳遞)------------------
i=0, ints[0]=0
呼叫後 i=0 (不變), ints[0]=100 (變為 100)
-----------TestInt (ref)------------------
呼叫後 i=200 (變為 200), ints[0]=200 (變為 200)
-----------TestInt2 (out)------------------
呼叫後 i=300 (變為 300), ints[0]=300 (變為 300)
--- ref 需初始化,out 不需 ---
k=300 (out 參數成功接收值)
int i 傳入時複製副本,方法內修改不影響外部。ref 雙向傳遞:呼叫前必須初始化,方法可讀取原值並修改。out 單向輸出:呼叫前可不初始化,但方法必須在所有路徑上賦值後才能返回,編譯器會強制檢查。ref;純「輸出」時用 out(語意更清晰,且允許未初始化)。ref/out,增加耦合度與認知負擔;考慮回傳 Tuple、ValueTuple 或自訂結果物件。ref 與 out 在方法簽章中屬於不同簽章,可構成多載,但不能僅靠 ref/out 差異多載(如同時存在 void M(ref int x) 與 void M(out int x) 會編譯錯誤)。掌握 C# 參數傳遞機制,關鍵在於區分「傳遞的是值還是參考」以及「呼叫端與被呼叫端共享記憶體位置」。ref 與 out 雖同屬引用傳遞,但初始化要求與語意意圖截然不同。善用這兩個關鍵字能寫出更安全、意圖更明確的程式碼。