Plėtinio metodai leidžia "pridėti" metodus prie esamų tipų (įskaitant tipus, kurie jums nepriklauso, pvz. string arba int) nemodifikuodami jų ir nenepavelkydami. Jie apibrėžiami kaip statiniai metodai su this modifikatoriumi pirmame parametre ir iškviečiami taip, tarsi jie būtų objektiniai metodai. LINQ pagrįstas jais.
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 modifikatorius pirmame parametre pažymi metodą kaip to tipo plėtinį. Tai statinis metodas, bet jūs jį iškviečiate kaip objektinį metodą (str.IsValidEmail()), o tai skamba natūraliai.
// these are equivalent — the extension call is sugar for a static call
"[email protected]".IsValidEmail();
StringExtensions.IsValidEmail("[email protected]");
Plėtinio metodai yra kompiliatoriaus magija — jie iš tikrųjų yra statiniai metodų iškviedimai, tačiau this-parametro sintaksė leidžia juos iškviesti sklandžiai, tarsi jie priklausytų tipui. (Jie turi būti statinėje klasėje ir vardų sritis importuota su 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
Visi LINQ operatoriai (Where, Select ir kt.) yra plėtinio metodai ant IEnumerable<T> — todėl jie susijungia taip sklandžiai. Tai yra svarbiausias plėtinio metodų naudojimas.
Plėtinio metodai yra svarbi ir charakteringa C# savybė, ir jų supratimas yra vertingas tiek jų naudojimui, tiek norint suprasti, kaip veikia pagrindinės C# dalys — ypač LINQ, kuris visiškai pagrįstas plėtinio metodais (operatoriai Where/Select/OrderBy yra plėtiniai ant IEnumerable<T>, todėl jie susijungia taip sklandžiai).
Ši savybė leidžia pridėti funkcionalumą prie esamų tipų — įskaitant tuos, kurie jums nepriklauso (string, int, sisteminės bibliotekos tipai) arba kuriuos negali modifikuoti (uždaros klasės, sąsajos) — be paveldėjimo ar originalaus modifikavimo, išlaikant švarų, sklandų iškviečiamąją sintaksę (str.IsValidEmail() skamba kaip objektinis metodas).
Tai naudinga rašant pagalbos metodus, kurie natūraliai išplečia tipus, statant sklandžias API ir pridedant elgesį sąsajoms.
Supratimas apie plėtinio metodus — kaip juos apibrėžti (this pirmame parametre, statinėje klasėje), kad jie yra sintaksinė cukrus statiniams iškviečiamams, ir ypač, kad LINQ yra pagrįstas jais — yra svarbus žinios dalis tiek rašant švarų, sklandų C# pagalbininką ir suprantant, kaip LINQ bei daugelis sklandžių .NET API pasiekia savo sintaksę.
Kaip plėtinio metodai iš esmės remia vieną iš svarbiausių C# savybių (LINQ) ir yra bendras būdas elegantiškai išplėsti tipus, jų žinojimas yra dažnai taikoma žinios dalis, atspindinti supratimą apie tai, kaip veikia C# sklandžios, išplečiamos API — ir leidžia rašyti panašiai švarų, lengvai atrandamą kodą.