| 關鍵字 | 傳遞方向 | 存儲位置 | 能否修改實參 | 調用點語法 |
|---|---|---|---|---|
| (無) | In | 新建棧槽,複製值 | 不可(值類型) 可修改對象內部(引用類型) | M(arg) |
ref | In/Out | 共享實參存儲位置 | 可(替換整個變量) | M(ref arg) |
out | Out | 共享實參存儲位置 | 必須在方法內賦值 | M(out arg) |
in (7.0+) | In | 共享實參存儲位置(唯讀) | 編譯期禁止寫入 | M(in arg) |
params | In | 隱式建立數組 | 不可修改數組引用,可修改元素 | M(1,2,3) 或 M(arr) |
void SwapVal(int a, int b) {
int t = a; a = b; b = t; // 僅影響副本
}
int x=1, y=2;
SwapVal(x, y);
Console.WriteLine($"{x}, {y}"); // 1, 2
引用類型傳遞的是**引用的副本**,可修改對象內容,不可替換引用本身:
void ModifyList(List list) {
list.Add(99); // 影響原列表
list = new List(); // 僅影響局部變量
}
var lst = new List{1};
ModifyList(lst);
Console.WriteLine(lst.Count); // 2
ref 引用參數
void SwapRef(ref int a, ref int b) {
int t = a; a = b; b = t;
}
int x=1, y=2;
SwapRef(ref x, ref y);
Console.WriteLine($"{x}, {y}"); // 2, 1
// 引用類型也可替換整個對象
void ReplaceRef(ref List list) {
list = new List{9,9};
}
var lst = new List{1};
ReplaceRef(ref lst);
Console.WriteLine(string.Join(",", lst)); // 9,9
規則:實參必須**已初始化**,調用時必須加 ref。
out 輸出參數
bool TryParse(string s, out int result) {
return int.TryParse(s, out result); // 必須賦值 result
}
// 調用
if (TryParse("42", out int n)) Console.WriteLine(n); // 42
// n 在此作用域可用(C# 7.0+ 內聯聲明)
與 ref 差異:
out 參數**不要求調用前初始化**,但**方法內所有路徑必須賦值**。ref = 雙向,out = 單向輸出。out 標記為 [Out],ref 標記 [In][Out],影響互操作。in 唯讀引用(C# 7.2+)
void ReadOnly(in BigStruct data) {
// data = new BigStruct(); // 編譯錯誤 CS8331
Console.WriteLine(data.Value);
}
readonly struct 可優化消除副本。params 參數數組
void Log(string format, params object[] args) {
Console.WriteLine(format, args);
}
Log("User {0} login from {1}", "Alice", "192.168.1.1"); // 隱式 new object[]{...}
Log("No args"); // args = new object[0]
// 僅能出現在參數列表最後,且每個方法僅一個 params
// 適用類型:任意類型數組(含 params IEnumerable 7.0+)
out
// 舊式
void GetName(out string first, out string last) { ... }
// 新式:元組返回,語義清晰、支持解構
(string First, string Last) SplitName(string full) {
var parts = full.Split(' ');
return (parts[0], parts[1]);
}
var (f, l) = SplitName("John Doe");
ref struct / ref return / ref local(進階高效能)
ref int FindFirst(int[] arr, int target) {
for (int i = 0; i < arr.Length; i++)
if (arr[i] == target) return ref arr[i];
throw new KeyNotFoundException();
}
var nums = new[]{1,2,3};
ref int r = ref FindFirst(nums, 2);
r = 20; // 直接修改數組元素
Console.WriteLine(nums[1]); // 20
object o = 1; ref int r = ref (int)o; **非法**,裝箱後無法取地址。ref/out:async Task Foo(ref int x) 編譯錯誤。改用 Tuple 或 ValueTuple 返回。ref/out:yield return 方法參數不可為 ref/out。M(int) vs M(ref int) vs M(out int) 視為不同簽名,可共存。void M(int x = 0) 不能用於 ref/out/params。C# 參數修飾符提供精確的內存與語義控制:
readonly struct 零拷貝。善用現代特性(元組、in、ref return)能寫出更安全、高效、可讀的代碼。