C# Reference ยท .NET, Tools and Concepts
C# and .NET glossary
A glossary of C# and .NET terms: CLR, JIT, assembly, delegate, closure, boxing, record, Span, async, LINQ and more, with short runnable demos.
C# and .NET come with their own vocabulary, and some words are easy to mix up: the language versus the platform, the runtime versus the SDK, a value type versus a reference type. This glossary gives short, precise definitions and links to the reference pages that explain each idea in depth.
Terms are grouped by theme. Two small programs at the top demonstrate the ideas that confuse people most: value versus reference semantics, and closures.
Try it
A value type is copied on assignment; a reference type shares one object between variables.
Press Run (or Ctrl + Enter) to see the result here.
Program input ยท what you'd type while the program runs
Type the answers before you press Run, one per line. Each time the program reads a line (with Console.ReadLine()), it gets the next line from this box.
A closure is a lambda that captures variables from the surrounding method. A delegate is the type-safe object that holds the method.
Press Run (or Ctrl + Enter) to see the result here.
Program input ยท what you'd type while the program runs
Type the answers before you press Run, one per line. Each time the program reads a line (with Console.ReadLine()), it gets the next line from this box.
Platform and tooling
| Term | Meaning |
|---|---|
| .NET | The cross-platform platform for building apps: runtime, libraries and tools. Modern versions are called ".NET 8", ".NET 10" (no "Core" any more). See C# and .NET versions. |
| .NET Framework | The older Windows-only .NET (up to 4.8). Still supported but not developed further. |
| C# | The language. Versions (C# 13, C# 14) are tied to .NET versions but are separate things. |
| CLR | Common Language Runtime: executes code, manages memory, handles exceptions and security. See The .NET runtime. |
| IL (CIL) | Intermediate Language: what the C# compiler emits, before machine code. |
| JIT | Just-in-time compiler: turns IL into machine code as methods first run. Tiered compilation starts quickly, then re-optimizes hot methods. |
| AOT | Ahead-of-time compilation (Native AOT) to a native executable with no JIT; has restrictions on reflection. |
| BCL | Base Class Library: System.* types such as List<T>, string, File. |
| SDK | Software Development Kit: compiler, dotnet CLI, templates and build targets. The runtime alone runs apps but cannot build them. |
| Roslyn | The open-source C# and Visual Basic compiler, also the engine behind analyzers and source generators. |
| NuGet | The package manager and feed for .NET libraries. See Assemblies and NuGet. |
| Assembly | A compiled unit (.dll or .exe) holding IL and metadata. |
| Project / solution | A .csproj builds one assembly; a .sln groups projects. See Project files. |
| Target framework (TFM) | The .NET version a project builds for, such as net10.0. |
| Garbage collector (GC) | Frees unreachable objects automatically. See Garbage collection. |
| Managed / unmanaged | Managed code runs under the CLR; unmanaged (native) code does not. |
Language terms
| Term | Meaning |
|---|---|
| Value type | struct, enum and built-in numbers; stored inline and copied on assignment. |
| Reference type | class, record, interface, delegate, arrays, string; variables hold references to heap objects. |
| Boxing / unboxing | Copying a value type into an object on the heap, and back. Costs an allocation. |
| Nullable reference types | Compiler analysis that tracks whether a reference may be null. See Nullable context. |
| Record | A type with value-based equality, with copying and a concise declaration. |
| Generic | A type or method with type parameters (List<T>), checked at compile time and specialized at run time. |
| Delegate | A type-safe reference to a method; Action and Func are the common ones. |
| Lambda | An inline anonymous function: x => x * 2. |
| Closure | A lambda together with the outer variables it captures. |
| Extension method | A static method called like an instance method (text.IsBlank()). |
| Pattern matching | Testing a value's shape with is and switch patterns. |
| Property | A member that looks like a field but runs accessors (get, set, init). |
| Indexer | A property used with square brackets: list[0]. |
| Attribute | Metadata attached to code, such as [Obsolete]. |
| Expression tree | Code represented as data (Expression<Func<T>>) so a library can analyze or translate it. |
| Top-level statements | A program without an explicit Main. See Top-level statements. |
Libraries and runtime concepts
| Term | Meaning |
|---|---|
| LINQ | Language Integrated Query: query operators (Where, Select, GroupBy) over sequences. Usually deferred: it runs when you enumerate. |
IEnumerable<T> / IQueryable<T> |
In-memory sequence versus a query a provider (such as EF Core) can translate. |
| Task / async / await | A promise of a future result, and the syntax that waits for it without blocking a thread. |
| Span<T> | A stack-only view over contiguous memory, no copying. |
| Dependency injection (DI) | Handing an object its dependencies rather than letting it create them. See Options and configuration. |
| Middleware | A component in the ASP.NET Core request pipeline. See ASP.NET Core overview. |
| Minimal API | An HTTP endpoint declared as a lambda. See Minimal APIs. |
| Host | The object owning a long-running app's services and lifetime. See Generic host. |
| EF Core | The ORM for .NET. See Entity Framework Core overview. |
| Analyzer | A Roslyn component that reports code issues at build time. See Analyzers and code style. |
| Source generator | A compiler plug-in that adds code at build time. |
| Reflection | Inspecting and invoking types at run time. |
| Culture / invariant culture | The language and region rules for formatting and comparing; invariant means culture-independent. |
| xUnit / NUnit / MSTest | Test frameworks. See Testing in .NET. |
Usage notes
- ".NET Core" is gone from the name. ".NET 5" and later are the unified successor of both .NET Core and .NET Framework.
- The language version follows the target framework by default. Change it with
<LangVersion>only when you need to; some features also need runtime support. - Runtime versus SDK. Production machines need the runtime (or a self-contained publish); development machines need the SDK.
- LTS and STS. Even-numbered releases are long-term support; odd-numbered ones have shorter support.
- Terms that sound alike: a thread is an OS execution path, a task is a unit of async work that may use no thread while waiting; a parameter is the declared name, an argument is the value passed in.