Extension methods vam omogućavaju da "dodate" metode postojećim tipovima (uključujući tipove koje ne posjedujete, kao string ili int) bez mijenjanja ili naslijeđivanja. Definirani su kao statičke metode s this modifikatorom na prvom parametru, a pozivaju se kao da su instance metode. LINQ je izgrađen na njima.
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 ..."
this modifikator na prvom parametru označava metodu kao proširenje tog tipa. To je statička metoda, ali je pozivate kao instance metodu (str.IsValidEmail()), što se čita prirodno.
// these are equivalent — the extension call is sugar for a static call
"[email protected]".IsValidEmail();
StringExtensions.IsValidEmail("[email protected]");
Extension methods su compiler magija — zapravo su pozivi statičkih metoda, ali this-parametar sintaksa vam omogućava da ih pozovete fluidno kao da su pripadale tipu. (Moraju biti u statičkoj klasi i namespace importan s 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
Svi LINQ operatori upita (Where, Select, itd.) su extension methods na IEnumerable<T> — što je razlog zašto se lanac tako fluidno. Ovo je najprominentnija upotreba extension metoda.
Extension methods su važna i karakteristična C# značajka, a razumijevanje njih je vrijedno za korištenje i za razumijevanje kako ključni dijelovi C# funkcioniraju — posebno LINQ, koji je u potpunosti izgrađen na extension metodama (operatori Where/Select/OrderBy su proširenja na IEnumerable<T>, što je razlog zašto se lanac tako fluidno).
Značajka vam omogućava da dodate funkcionalnost postojećim tipovima — uključujući one koje ne posjedujete (string, int, framework tipove) ili ne možete mijenjati (sealed klase, interfejsi) — bez naslijeđivanja ili mijenjanja originalnog, dok održavate čist, fluidni poziv (str.IsValidEmail() se čita kao instance metoda).
Ovo je korisno za pisanje pomoćnih metoda koje prirodno proširuju tipove, gradnju fluidnih API-ja i dodavanje ponašanja sučeljima.
Razumijevanje extension metoda — kako ih definirati (this na prvom parametru, u statičkoj klasi), da su sintaksna šećer za statičke pozive, i posebno da je LINQ izgrađen na njima — je važno znanje za pisanje čistih, fluidnih C# pomoćnika i razumijevanje kako LINQ i mnogi fluidni .NET API-ji postižu svoju sintaksu.
Budući da extension methods podupiru jednu od C#-ovih najvažnijih značajki (LINQ) i čest su način za elegantno proširenje tipova, njihovo znanje je često primijenjeno znanje koje odražava razumijevanje kako C#-ovi fluidni, proširivi API-ji funkcioniraju — i omogućava vam pisanje slično čistog, otkrivajućeg koda.