C# 擴充方法深度解析：語法、IntelliSense 與實戰模式

什麼是擴充方法？

擴充方法讓你在不修改原型別、不繼承的前提下，為現有型別「新增」實例方法。語法要求：

• 定義於 static 類別中
• 方法本身為 static
• 第一個參數加上 this 修飾詞，指定被擴充的型別

基本語法與 IntelliSense 效果

public static class DataReaderExtensions
{
    public static string GetString(this IDataReader dr, string columnName)
        => dr.GetString(dr.GetOrdinal(columnName));

    public static int GetInt32(this IDataReader dr, string columnName)
        => dr.GetInt32(dr.GetOrdinal(columnName));
}

使用時：

using MyExtensions; // 必須引入命名空間

var name = reader.GetString("UserName"); // IntelliSense 顯示為擴充方法（藍色下箭頭圖示）
var age = reader.GetInt32("Age");

Visual Studio 會在成員清單中以特殊圖示標示擴充方法，並自動帶入 this 參數。

進階模式：擴充介面與多型行為

擴充 IDataReader 介面，所有實作類別（SqlDataReader、OracleDataReader 等）自動獲得擴充方法：

public static T GetValue(this IDataReader dr, string name)
{
    var ordinal = dr.GetOrdinal(name);
    return (T)dr.GetValue(ordinal);
}

// 使用
var id = reader.GetValue("Id");
var email = reader.GetValue("Email");

擴充 Object：全域可用的工具方法

public static class ObjectExtensions
{
    public static bool IsIn(this object item, IEnumerable collection)
    {
        foreach (var elem in collection)
            if (Equals(item, elem)) return true;
        return false;
    }

    public static bool IsEmail(this string text)
        => Regex.IsMatch(text, @"^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$");
}

所有型別（含實值型別經裝箱）皆可呼叫：

if (userInput.IsEmail()) { ... }
if (selectedItem.IsIn(validOptions)) { ... }

命名空間與可見性控制

• 擴充方法只在 using 其命名空間時可見，避免污染全域 IntelliSense
• 建議將擴充方法集中放在 *.Extensions 命名空間
• 同簽章的實例方法優先於擴充方法（編譯器解析規則）

LINQ 的基石

LINQ 標準查詢運算子（Where、Select、GroupBy...）本質都是擴充 IEnumerable<T> 的靜態方法。理解擴充方法機制，有助於深入掌握 LINQ 延遲執行、串流處理等核心概念。

最佳實踐與陷阱