C# 參數傳遞機制是開發者必須精通的基石。本文透過一個「三數排序、求和、平均」的綜合範例,示範值傳遞、ref 引用傳遞與 out 輸出參數在實際業務邏輯中的協同運作,並補充核心觀念問答,助你建立完整心智模型。
using System;
class Program
{
// 1. 純值傳遞:排序三個整數(不影響呼叫端變數)
static void Sort(int x, int y, int z)
{
int temp = 0;
if (x > y) { temp = x; x = y; y = temp; }
if (y > z)
{
temp = z; z = y;
if (x > temp) { y = x; x = temp; }
else { y = temp; }
}
Console.WriteLine($"排序結果: {x}, {y}, {z}");
x = x + y + z; // 只修改區域副本
}
// 2. 混合引用傳遞:ref 供輸入/輸出,out 純輸出總和
static double Average(ref int i, ref int j, ref int k, out int total)
{
total = i + j + k; // out 必須賦值
i = total; // ref 修改原變數
return (double)total / 3.0;
}
static void Main()
{
int a, b, c;
int result; // out 參數可不初始化
Console.Write("請輸入第一個數 a = "); a = Convert.ToInt32(Console.ReadLine());
Console.Write("請輸入第二個數 b = "); b = Convert.ToInt32(Console.ReadLine());
Console.Write("請輸入第三個數 c = "); c = Convert.ToInt32(Console.ReadLine());
// 呼叫值傳遞方法
Sort(a, b, c);
Console.WriteLine($"a 仍為 {a} (值傳遞不影響原變數)");
// 呼叫引用傳遞方法
double avg = Average(ref a, ref b, ref c, out result);
Console.WriteLine($"平均值: {avg}");
Console.WriteLine($"a 變為 {a} (ref 修改原變數), 總和 result = {result}");
Console.ReadLine();
}
}
x 均只影響區域副本,Main 中的 a, b, c 保持不變。ref int i/j/k:傳遞變數位址,方法內修改 i = total 直接改變 Main 的 a。out int total:方法必須賦值 total = i+j+k,呼叫端 result 接收總和,無需預先初始化。A: 執行時期為形參另行配置記憶體,並將實參值「位元複製」過去。形參持有的是獨立副本,任何修改皆在副本上進行,原實參記憶體區塊不受波及。
A:
| 維度 | 值傳遞 | 引用傳遞 (ref/out) |
|---|---|---|
| 傳遞內容 | 實參值的副本 | 實參的記憶體位址 (引用) |
| 形參與實參關係 | 獨立記憶體區塊 | 指向同一記憶體區塊 |
| 方法內修改影響 | 不影響實參 | 直接影響實參 |
| 適用類型 | 所有類型 (預設) | 需加 ref/out 修飾 |
形參:方法宣告時定義的參數佔位符,僅在方法呼叫時分配記憶體,返回後釋放。
實參:呼叫時傳入的具體值/變數/運算式,必須有確定值,記憶體位置與形參不同。
只有 值傳遞 + 值類型** 會完全隔離修改;其餘三種組合(值傳遞+引用類型、引用傳遞+值類型、引用傳遞+引用類型)皆允許方法影響原始資料(對引用類型而言,指的是修改物件內容或重新指派參考)。
透過具體的排序與平均計算範例,我們看見 ref 適合「雙向資料流」(如排序後要回寫原變數),out 適合「單向輸出」(如 TryParse 模式)。理解底層記憶體行為,能避免微妙 Bug 並設計出意圖清晰的 API。