Extension methods membolehkan anda "menambah" methods kepada jenis sedia ada (termasuk jenis yang anda tidak miliki, seperti string atau int) tanpa mengubah suainya atau mewarisinya. Ia ditakrifkan sebagai static methods dengan modifier this pada parameter pertama, dan dipanggil seolah-olah ia adalah instance methods. LINQ dibina berdasarkannya.
public static class StringExtensions
{
// `this string str` makes this an extension method ON string
public static bool IsValidEmail(this string str)
{
return str.Contains("@") && str.Contains(".");
}
public static string Truncate(this string str, int max)
{
return str.Length <= max ? str : str[..max] + "...";
}
}
// call them as if they were instance methods on string
"[email protected]".IsValidEmail(); // true
"long text here".Truncate(5); // "long ..."
Modifier this pada parameter pertama menandakan method tersebut sebagai sambungan kepada jenis itu. Ia adalah static method, tetapi anda memanggilnya seperti instance method (str.IsValidEmail()), yang dibaca secara semula jadi.
// these are equivalent — the extension call is sugar for a static call
"[email protected]".IsValidEmail();
StringExtensions.IsValidEmail("[email protected]");
Extension methods adalah keajaiban compiler — ia sebenarnya panggilan static method, tetapi sintaks parameter-this membolehkan anda memanggilnya secara fasih seolah-olah ia kepunyaan jenis tersebut. (Ia mesti berada dalam static class dan namespace diimport dengan using.)
// Where, Select, OrderBy, etc. are extension methods on IEnumerable<T>
list.Where(x => x > 0).Select(x => x * 2);
// → IEnumerable<T> has no Where method; LINQ ADDS them via extension methods
Semua operator pertanyaan LINQ (Where, Select, dsb.) ialah extension methods pada IEnumerable<T> — itulah sebabnya ia berangkai begitu fasih. Ini adalah penggunaan extension methods yang paling menonjol.
Extension methods ialah ciri C# yang penting dan tersendiri, dan memahaminya bernilai baik untuk menggunakannya mahupun untuk memahami bagaimana bahagian penting C# berfungsi — terutamanya LINQ, yang sepenuhnya dibina berdasarkan extension methods (operator Where/Select/OrderBy ialah sambungan pada IEnumerable<T>, itulah sebabnya ia berangkai begitu fasih).
Ciri ini membolehkan anda menambah fungsi kepada jenis sedia ada — termasuk yang anda tidak miliki (string, int, jenis framework) atau tidak boleh ubah suai (sealed classes, interfaces) — tanpa pewarisan atau mengubah suai yang asal, sambil mengekalkan sintaks panggilan yang bersih dan fasih (str.IsValidEmail() dibaca seperti instance method).
Ini berguna untuk menulis helper methods yang melanjutkan jenis secara semula jadi, membina fluent APIs, dan menambah tingkah laku kepada interfaces.
Memahami extension methods — bagaimana mentakrifkannya (this pada parameter pertama, dalam static class), bahawa ia adalah syntactic sugar untuk panggilan static, dan terutamanya bahawa LINQ dibina berdasarkannya — adalah pengetahuan penting baik untuk menulis helper C# yang bersih dan fasih mahupun untuk memahami bagaimana LINQ dan banyak fluent .NET API mencapai sintaks mereka.
Memandangkan extension methods menyokong salah satu ciri C# yang paling penting (LINQ) dan merupakan cara biasa untuk melanjutkan jenis secara elegan, mengetahuinya adalah pengetahuan yang kerap digunakan yang mencerminkan pemahaman tentang bagaimana fluent, extensible API C# berfungsi — dan membolehkan anda menulis kod yang sama bersih dan boleh ditemui.