Razširitetne metode vam omogočajo "dodati" metode obstoječim tipom (vključno s tipi, ki jih ne lastite, kot sta string ali int) brez njihove spremembe ali dedovanja. Definirane so kot statične metode z modifikatorjem this na prvem parametru in se kličejo kot da bi bile inačice metod. LINQ je zgrajen na njih.
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 ..."
Modifikator this na prvem parametru označi metodo kot razširitev tega tipa. To je statična metoda, vendar jo kličete kot inačico metode (str.IsValidEmail()), kar se naravno bere.
// these are equivalent — the extension call is sugar for a static call
"[email protected]".IsValidEmail();
StringExtensions.IsValidEmail("[email protected]");
Razširitetne metode so kompilatorska magija — dejansko so statični klici metod, vendar vam sintaksa s parametrom this omogoča, da jih kličete tekoče kot da bi pripadale tipu. (Biti morajo v statičnem razredu in prostor imen uvožen z 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
Vsi operatorji LINQ poizvedb (Where, Select itd.) so razširitetne metode na IEnumerable<T> — zato se verige tako tekoče. To je najbolj vidna uporaba razširitetnih metod.
Razširitetne metode so pomembna in značilna lastnost C#, razumevanje njih pa je dragoceno tako za njihovo uporabo kot za razumevanje, kako delujejo ključni deli C# — predvsem LINQ, ki je v celoti zgrajen na razširitetnih metodah (operatorji Where/Select/OrderBy so razširitve na IEnumerable<T>, zato se verige tako tekoče).
Lastnost vam omogoča dodajanje funkcionalnosti obstoječim tipom — vključno s tistimi, ki jih ne lastite (string, int, tipi ogrodja) ali jih ne morete spremeniti (zapečateni razredi, vmesniki) — brez dedovanja ali spremembe originala, ob ohranjanju čistega, tekočega sintaksa klica (str.IsValidEmail() se bere kot inačica metode).
To je koristno za pisanje pomožnih metod, ki naravno razširijo tipe, gradnjo tekočih API-jev in dodajanje vedenja vmesnikom.
Razumevanje razširitetnih metod — kako jih definirati (modifikator this na prvem parametru, v statičnem razredu), da so sintaksna sladkor za statične klice in posebej da je LINQ zgrajen na njih — je pomembno znanje tako za pisanje čistih, tekočih C# pomožnih sredstev kot za razumevanje, kako LINQ in številni tekoči .NET API-ji dosegajo svojo sintakso.
Ker razširitetne metode podpirajo eno od C#-ovih najbolj pomembnih lastnosti (LINQ) in so pogost način za elegantno razširitev tipov, je poznavanje njihove vrste pogosto uporabljano znanje, ki odraža razumevanje, kako delujejo C#-ovi tekoči, razširljivi API-ji — in vam omogoči pisanje podobno čistega, odkrivnega koda.