萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 方法參數完全指南:值、引用、輸出、參數數組與現代特性

參數傳遞機制核心表

關鍵字傳遞方向存儲位置能否修改實參調用點語法
(無)In新建棧槽,複製值不可(值類型)
可修改對象內部(引用類型)
M(arg)
refIn/Out共享實參存儲位置可(替換整個變量)M(ref arg)
outOut共享實參存儲位置必須在方法內賦值M(out arg)
in (7.0+)In共享實參存儲位置(唯讀)編譯期禁止寫入M(in arg)
paramsIn隱式建立數組不可修改數組引用,可修改元素M(1,2,3) 或 M(arr)

1. 值參數(預設)


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

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。

3. 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 = 單向輸出。
  • CLR 簽名中 out 標記為 [Out],ref 標記 [In][Out],影響互操作。

4. in 唯讀引用(C# 7.2+)


void ReadOnly(in BigStruct data) {
    // data = new BigStruct(); // 編譯錯誤 CS8331
    Console.WriteLine(data.Value);
}
  • 避免大結構體複製開銷,同時防止意外修改。
  • 編譯器可能創建**防禦性副本**(defensive copy)以確保不可變性,對 readonly struct 可優化消除副本。

5. 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+)

6. 現代組合特性(C# 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

常見陷阱與最佳實踐

  1. 值類型裝箱:object o = 1; ref int r = ref (int)o; **非法**,裝箱後無法取地址。
  2. 異步方法不能用 ref/out:async Task Foo(ref int x) 編譯錯誤。改用 Tuple 或 ValueTuple 返回。
  3. 迭代器不能用 ref/out:yield return 方法參數不可為 ref/out。
  4. 重載解析:M(int) vs M(ref int) vs M(out int) 視為不同簽名,可共存。
  5. 預設參數值:void M(int x = 0) 不能用於 ref/out/params。

總結

C# 參數修飾符提供精確的內存與語義控制:

  • **值參數** 適合小型不可變數據。
  • **ref** 雙向修改,需初始化。
  • **out** 純輸出,多返回值首選元組。
  • **in** 大結構體只讀傳遞,配合 readonly struct 零拷貝。
  • **params** 簡化可變參數調用。

善用現代特性(元組、in、ref return)能寫出更安全、高效、可讀的代碼。

copyright © 萬盛學電腦網 all rights reserved