Extension methods lader dig "tilføje" metoder til eksisterende typer (herunder typer du ikke ejer, som string eller int) uden at ændre dem eller arve fra dem. De defineres som statiske metoder med en this modifier på den første parameter, og kaldes som om de var instansmetoder. LINQ er bygget på dem.
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 ..."
Modifieren this på den første parameter markerer metoden som en udvidelse af denne type. Det er en statisk metode, men du kalder den som en instansmetode (str.IsValidEmail()), hvilket læses naturligt.
// these are equivalent — the extension call is sugar for a static call
"[email protected]".IsValidEmail();
StringExtensions.IsValidEmail("[email protected]");
Extension methods er compiler-magi — de er virkelig statiske metodekald, men this-parameter-syntaksen lader dig kalde dem flydende som om de tilhørte typen. (De skal være i en statisk klasse, og namespace'et skal importeres med 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
Alle LINQ's forespørgselsoperatorer (Where, Select osv.) er extension methods på IEnumerable<T> — hvilket er grunden til, at de kædes så flydende. Dette er den mest fremtrædende brug af extension methods.
Extension methods er en vigtig og karakteristisk C#-funktion, og at forstå dem er værdifuldt både for at bruge dem og for at forstå, hvordan vigtige dele af C# virker — især LINQ, som er fuldstændig bygget på extension methods (Where/Select/OrderBy operatorerne er udvidelser på IEnumerable<T>, hvilket er grunden til, at de kædes så flydende).
Funktionen lader dig tilføje funktionalitet til eksisterende typer — herunder dem du ikke ejer (string, int, framework-typer) eller ikke kan ændre (sealed-klasser, interfaces) — uden arv eller ændring af originalen, samtidig med at du bevarer en ren, flydende kaldessyntaks (str.IsValidEmail() læses som en instansmetode).
Dette er nyttigt til at skrive hjælpemetoder, der udvider typer naturligt, til at bygge flydende API'er og til at tilføje adfærd til interfaces.
At forstå extension methods — hvordan man definerer dem (this på den første parameter, i en statisk klasse), at de er syntaktisk sukker for statiske kald, og især at LINQ er bygget på dem — er vigtig viden både for at skrive ren, flydende C#-hjælpere og for at forstå, hvordan LINQ og mange flydende .NET-API'er opnår deres syntaks.
Da extension methods ligger til grund for en af C#'s vigtigste funktioner (LINQ) og er en almindelig måde at udvide typer elegant på, er det hyppigt-brugt viden at kende dem, hvilket afspejler forståelse af, hvordan C#'s flydende, udvidelige API'er virker — og lader dig skrive tilsvarende ren, letdiskoverbar kode.