方法多載 是 C# 實現多型的基礎技術之一,但濫用或設計不當會導致 API 混亂、呼叫端模糊不清。本文依據 Microsoft 設計指導方針,詳細說明多載的必要條件、參數命名/順序規範、擴展性設計、預設參數替代方案,並釐清與 Override (覆寫) 的本質差異。
public void Write(string message, FileStream stream) { }
public void Write(string line, FileStream file, bool closeStream) { } // message vs line, stream vs file
public void Write(string message, FileStream stream) { }
public void Write(string message, FileStream stream, bool closeStream) { }
原則:代表相同意義的參數,在所有多載中必須使用相同名稱,方便 IntelliSense 與呼叫端閱讀。
public void Write(string message, FileStream stream) { }
public void Write(FileStream stream, string message, bool closeStream) { }
public void Write(string message, FileStream stream) { }
public void Write(string message, FileStream stream, bool closeStream) { }
單純為了「參數可選」時,優先使用預設參數,減少多載數量:
// 推薦:單一方法 + 預設參數
public void Write(string message, FileStream stream, bool closeStream = false, Encoding encoding = null)
{
encoding ??= Encoding.UTF8;
// ...
}
// 僅在語意截然不同、或預設參數會造成語意模糊時才用多載
public void Write(string message, TextWriter writer) { ... } // 不同抽象層級
public class Logger
{
// 1. 最完整簽章設為 virtual,衍生類可覆寫核心邏輯
public virtual void Log(string message, LogLevel level, Exception ex, object context) { ... }
// 2. 較簡單多載「鏈式呼叫」最完整者,避免重複程式碼
public void Log(string message, LogLevel level, Exception ex)
=> Log(message, level, ex, null);
public void Log(string message, LogLevel level)
=> Log(message, level, null, null);
public void Log(string message)
=> Log(message, LogLevel.Info, null, null);
}
優點:維護單一核心邏輯、衍生類僅需覆寫一處、新增參數不破壞現有呼叫端。
params 必須是 最後一個 參數,且每個方法僅能有一個。out/ref 參數慣例放在最後,且不參與多載簽章區分 (即無法只靠 ref/out 差異多載)。| 特性 | Overload (多載) | Override (覆寫) |
|---|---|---|
| 關係 | 同一類別內多個同名方法 | 基類與衍生類之間 |
| 簽章 | 參數清單必須不同 | 名稱、參數、回傳型別必須完全相同 |
| 關鍵字 | 無 (隱含) | virtual/abstract + override |
| 多型 | 編譯期靜態綁定 (靜態多型) | 執行期動態綁定 (動態多型) |
| 目的 | 提供不同參數便利性 | 改變/擴充基類行為 |
// ❌ 難以閱讀呼叫意圖
public void Save(bool validate) { ... }
public void Save() { ... }
// ✅ 拆分為語意明確的方法
public void Save() { Save(validate: true); }
public void SaveWithoutValidation() { Save(validate: false); }
改用 建造者模式 或 選項物件:
public class ReportOptions
{
public bool IncludeHeader { get; set; } = true;
public bool IncludeFooter { get; set; } = false;
public ExportFormat Format { get; set; } = ExportFormat.Pdf;
// ...
}
public void GenerateReport(ReportOptions options) { ... }
virtual,簡單多載鏈式呼叫。