C# 方法宣告語法詳解：修飾詞、回傳值、參數列表與方法本體規範

方法宣告完整語法結構

[attributes] [method-modifiers] return-type member-name (formal-parameter-list)
{
    // method-body: 陳述式區塊
}

必要與可選元素

回傳值機制

• return 運算式;：回傳值並離開方法。
• return;：僅用於 void 方法提前離開。
• 非 void 方法所有路徑必須回傳值，否則編譯錯誤 CS0161。
• C# 7.0+ 支援 ref return 回傳參考。

public int Max(int x, int y) {
    if (x > y) return x;
    return y; // 確保所有路徑回傳
}

方法修飾詞完整對照 (含現代擴充)

互斥組 A：static/virtual/override/abstract 任兩兩互斥。

參數列表詳細語法

[attributes] [parameter-modifiers] type identifier [= default-value]
parameter-modifiers: ref / out / in / params

參數修飾詞規則

• ref、out、in 互斥，不可共用。
• params 僅能出現在最後一個參數，且型別必須為一維陣列。
• in 參數 (C# 7.2+) 僅讀，防止意外修改，適合大型 readonly struct。

方法命名慣例與限制

• PascalCase：CalculateTotal, GetUserById。
• 布林回傳方法加前綴：IsValid, HasPermission, CanExecute。
• 非同步方法加 Async 後綴：DownloadAsync。
• 同類別內不可與欄位/屬性/事件同名 (多載除外)，否則編譯錯誤 CS0102。

partial class Generator {
    // 宣告 (可無本體)
    partial void OnGenerated(string code);
    // 實作 (可在另一個 partial 檔案)
    partial void OnGenerated(string code) => Console.WriteLine(code);
}