擴充方法被定義為靜態方法,但它們是通過執行個體方法文法進行調用的。它們的第一個參數指定該方法作用於哪個類型,並且該參數以 this 修飾符為首碼。僅當您使用 using 指令將命名空間顯式匯入到原始碼中之後,擴充方法才位於範圍中。
下面的樣本示範為 System..::.String 類定義的一個擴充方法。請注意,它是在非嵌套、非泛型靜態類內部定義的:
namespace ExtensionMethods
{
public static class MyExtensions
{
public static int WordCount(this String str)
{
return str.Split(new char[] { ' ', '.', '?' }, StringSplitOptions.RemoveEmptyEntries).Length;
}
}
}
可使用以下 using 指令將 WordCount 擴充方法放入範圍中:
using ExtensionMethods;
而且,可以在應用程式中使用以下文法對該擴充方法進行調用:
string s = "Hello Extension Methods";
int i = s.WordCount();
在代碼中,可以使用執行個體方法文法調用該擴充方法。但是,編譯器產生的中繼語言 (IL) 會將代碼轉換為對靜態方法的調用。因此,並未真正違反封裝原則。實際上,擴充方法無法訪問它們所擴充的類型中的私人變數。
通用準則
通常,建議您只在不得已的情況下才實現擴充方法,並謹慎地實現。只要有可能,必須擴充現有類型的用戶端代碼都應該通過建立從現有類型派生的新類型來達到這一目的。有關更多資訊,請參見繼承(C# 編程指南)。
在使用擴充方法來擴充您無法更改其原始碼的類型時,您需要承受該類型實現中的更改會導致擴充方法失效的風險。
如果您確實為給定類型實現了擴充方法,請記住以下兩點:
如果擴充方法與該類型中定義的方法具有相同的簽名,則擴充方法永遠不會被調用。
擴充方法被在命名空間層級放入範圍中。例如,如果您在同一個名為 Extensions 的命名空間中具有多個包含擴充方法的靜態類,則這些擴充方法將全部由 using Extensions; 指令放入範圍中。
類庫的實施者不應使用擴充方法來避免建立程式集的新版本。如果您要向庫中添加重要的新功能,並且您擁有原始碼,則應該遵循標準 .NET Framework 程式集版本控制準則。