The primary goal of this glossary is to clarify meanings of selected terms and acronyms that appear frequently in the .NET documentation.
Similar to JIT, this compiler also translates IL to machine code. In contrast to JIT compilation, AOT compilation happens before the application is executed and is usually performed on a different machine. Because AOT tool chains don't compile at run time, they don't have to minimize time spent compiling. That means they can spend more time optimizing. Since the context of AOT is the entire application, the AOT compiler also performs cross-module linking and whole-program analysis, which means that all references are followed and a single executable is produced.
A workload-specific API. Here are some examples:
- ASP.NET Web API
- Entity Framework (EF)
- Windows Presentation Foundation (WPF)
- Windows Communication Foundation (WCF)
- Windows Workflow Foundation (WF)
- Windows Forms (WinForms)
The original ASP.NET implementation that ships with the .NET Framework, also known as ASP.NET 4.x.
Sometimes ASP.NET is an umbrella term that refers to both the original ASP.NET and ASP.NET Core. The meaning that the term carries in any given instance is determined by context. Refer to ASP.NET 4.x when you want to make it clear that you're not using ASP.NET to mean both implementations.
A cross-platform, high-performance, open-source implementation of ASP.NET.
A .dll or .exe file that can contain a collection of APIs that can be called by applications or other assemblies.
An assembly may include types such as interfaces, classes, structures, enumerations, and delegates. Assemblies in a project's bin folder are sometimes referred to as binaries. See also library.
Base Class Library.
A set of libraries that comprise the System.* (and to a limited extent Microsoft.*) namespaces. The BCL is a general purpose, lower-level framework that higher-level application frameworks, such as ASP.NET Core, build on.
The source code of the BCL for .NET 5 (and .NET Core) and later versions is contained in the .NET runtime repository. Most of these BCL APIs are also available in .NET Framework, so you can think of this source code as a fork of the .NET Framework BCL source code.
The following terms often refer to the same collection of APIs that BCL refers to:
Common Language Runtime.
A CLR handles memory allocation and management. A CLR is also a virtual machine that not only executes apps but also generates and compiles code on-the-fly using a JIT compiler.
The CLR implementation for .NET Framework is Windows only.
The CLR implementation for .NET 5 and later versions (also known as the Core CLR) is built from the same code base as the .NET Framework CLR. Originally, the Core CLR was the runtime of Silverlight and was designed to run on multiple platforms, specifically Windows and OS X. It's still a cross-platform runtime, now including support for many Linux distributions.
See also runtime.
The Common Language Runtime for .NET 5 (and .NET Core) and later versions.
In contrast to the CLR, CoreRT is not a virtual machine, which means it doesn't include the facilities to generate and run code on-the-fly because it doesn't include a JIT. It does, however, include the GC and the ability for run-time type identification (RTTI) and reflection. However, its type system is designed so that metadata for reflection isn't required. Not requiring metadata enables having an AOT tool chain that can link away superfluous metadata and (more importantly) identify code that the app doesn't use. CoreRT is in development.
The ability to develop and execute an application that can be used on multiple different operating systems, such as Linux, Windows, and iOS, without having to rewrite specifically for each one. This enables code reuse and consistency between applications on different platforms.
All of the runtime software, development tools, and community resources that are used to build and run applications for a given technology.
The term ".NET ecosystem" differs from similar terms such as ".NET stack" in its inclusion of third-party apps and libraries. Here's an example in a sentence:
- "The motivation behind .NET Standard was to establish greater uniformity in the .NET ecosystem."
In general, a comprehensive collection of APIs that facilitates development and deployment of applications that are based on a particular technology. In this general sense, ASP.NET Core and Windows Forms are examples of application frameworks. The words framework and library are often used synonymously.
The word "framework" has a different meaning in the following terms:
- framework libraries
- .NET Framework
- shared framework
- target framework
- TFM (target framework moniker)
- framework-dependent app
Sometimes "framework" refers to an implementation of .NET. For example, an article may call .NET 5+ a framework.
Meaning depends on context. May refer to the framework libraries for .NET 5 (and .NET Core) and later versions, in which case it refers to the same libraries that BCL refers to. It may also refer to the ASP.NET Core framework libraries, which build on the BCL and provide additional APIs for web apps.
The garbage collector is an implementation of automatic memory management. The GC frees memory occupied by objects that are no longer in use.
See Garbage Collection.
Higher-level .NET languages, such as C#, compile down to a hardware-agnostic instruction set, which is called Intermediate Language (IL). IL is sometimes referred to as MSIL (Microsoft IL) or CIL (Common IL).
Similar to AOT, this compiler translates IL to machine code that the processor understands. Unlike AOT, JIT compilation happens on demand and is performed on the same machine that the code needs to run on. Since JIT compilation occurs during execution of the application, compile time is part of the run time. Thus, JIT compilers have to balance time spent optimizing code against the savings that the resulting code can produce. But a JIT knows the actual hardware and can free developers from having to ship different implementations.
implementation of .NET
An implementation of .NET includes:
- One or more runtimes. Examples: CLR, CoreRT.
- A class library that implements a version of .NET Standard and may include additional APIs. Examples: the BCLs for .NET Framework and .NET 5 (and .NET Core) and later versions.
- Optionally, one or more application frameworks. Examples: ASP.NET, Windows Forms, and WPF are included in .NET Framework and .NET 5+.
- Optionally, development tools. Some development tools are shared among multiple implementations.
Examples of .NET implementations:
For more information, see .NET implementations.
A collection of APIs that can be called by apps or other libraries. A .NET library is composed of one or more assemblies.
The words library and framework are often used synonymously.
Mono is an open source, cross-platform .NET implementation that is mainly used when a small runtime is required. It is the runtime that powers Xamarin applications on Android, Mac, iOS, tvOS, and watchOS and is focused primarily on apps that require a small footprint.
It supports all of the currently published .NET Standard versions.
Historically, Mono implemented the larger API of the .NET Framework and emulated some of the most popular capabilities on Unix. It is sometimes used to run .NET applications that rely on those capabilities on Unix.
See the Mono documentation.
- In general, .NET is the umbrella term for .NET Standard and all .NET implementations and workloads.
- More specifically, .NET refers to the implementation of .NET that is recommended for all new development: .NET 5 (and .NET Core) and later versions.
.NET is always fully capitalized, never ".Net".
The plus sign after a version number means "and later versions." See .NET 5 and later versions.
.NET 5 and later versions
A cross-platform, high-performance, open-source implementation of .NET. Also referred to as .NET 5+. Includes a Common Language Runtime (CLR), an AOT runtime (CoreRT, in development), a Base Class Library (BCL), and the .NET SDK.
Earlier versions of this .NET implementation are known as .NET Core. .NET 5 is the next version following .NET Core 3.1. Version 4 was skipped to avoid confusing this newer implementation of .NET with the older implementation that is known as .NET Framework. The current version of .NET Framework is 4.8.
See .NET documentation.
A cross-platform toolchain for developing applications and libraries for .NET 5 (and .NET Core) and later versions. Also known as the .NET Core CLI.
See .NET CLI.
An implementation of .NET that runs only on Windows. Includes the Common Language Runtime (CLR), the Base Class Library (BCL), and application framework libraries such as ASP.NET, Windows Forms, and WPF.
See .NET Framework Guide.
Compilation happens on the developer's machine similar to the way a C++ compiler and linker works. It removes unused code and spends more time optimizing it. It extracts code from libraries and merges them into the executable. The result is a single module that represents the entire app.
UWP is the application framework supported by .NET Native.
A set of libraries and tools that allow developers to create .NET applications and libraries for .NET 5 (and .NET Core) and later versions. Also known as the .NET Core SDK.
Includes the .NET CLI for building apps, .NET libraries and runtime for building and running apps, and the dotnet executable (dotnet.exe) that runs CLI commands and runs applications.
See .NET SDK Overview.
A formal specification of .NET APIs that are available in each .NET implementation.
The .NET Standard specification is sometimes called a library. Because a library includes API implementations, not only specifications (interfaces), it's misleading to call .NET Standard a "library."
See .NET Standard.
Native (image) generation.
You can think of this technology as a persistent JIT compiler. It usually compiles code on the machine where the code is executed, but compilation typically occurs at install time.
A NuGet package—or just a package—is a .zip file with one or more assemblies of the same name along with additional metadata such as the author name.
The .zip file has a .nupkg extension and may contain assets, such as .dll files and .xml files, for use with multiple target frameworks and versions. When installed in an app or library, the appropriate assets are selected based on the target framework specified by the app or library. The assets that define the interface are in the ref folder, and the assets that define the implementation are in the lib folder.
An operating system and the hardware it runs on, such as Windows, macOS, Linux, iOS, and Android.
Here are examples of usage in sentences:
- ".NET Core is a cross-platform implementation of .NET."
- "PCL profiles represent Microsoft platforms, while .NET Standard is agnostic to platform."
Legacy .NET documentation sometimes uses ".NET platform" to mean either an implementation of .NET or the .NET stack including all implementations. Both of these usages tend to get confused with the primary (OS/hardware) meaning, so we try to avoid these usages.
"Platform" has a different meaning in the phrase "developer platform," which refers to software that provides tools and libraries for building and running apps. .NET is a cross-platform, open-source developer platform for building many different types of applications.
A POCO—or a plain old class/CLR object—is a .NET data structure that contains only public properties or fields. A POCO shouldn't contain any other members, such as:
These objects are used primarily as data transfer objects (DTOs). A pure POCO will not inherit another object, or implement an interface. It's common for POCOs to be used with serialization.
In general, the execution environment for a managed program. The OS is part of the runtime environment but is not part of the .NET runtime. Here are some examples of .NET runtimes in this sense of the word:
- Common Language Runtime (CLR)
- .NET Native (for UWP)
- Mono runtime
The word "runtime" has a different meaning in some contexts:
.NET runtime on the .NET 5 download page.
You can download the .NET runtime or other runtimes, such as the ASP.NET Core runtime. A runtime in this usage is the set of components that must be installed on a machine to run a framework-dependent app on the machine. The .NET runtime includes the CLR and the .NET shared framework, which provides the BCL.
.NET runtime libraries
Runtime here means the OS platform and CPU architecture that a .NET app runs on, for example:
Sometimes "runtime" is used in the sense of an implementation of .NET, as in the following examples:
- "The various .NET runtimes implement specific versions of .NET Standard. … Each .NET runtime version advertises the highest .NET Standard version it supports …"
- "Libraries that are intended to run on multiple runtimes should target this framework." (referring to .NET Standard)
Meaning depends on context. The .NET shared framework refers to the libraries included in the .NET runtime. In this case, the shared framework for .NET 5 (and .NET Core) and later versions refers to the same libraries that BCL refers to.
There are other shared frameworks. The ASP.NET Core shared framework refers to the libraries included in the ASP.NET Core runtime, which includes the BCL plus additional APIs for use by web apps.
For framework-dependent apps, the shared framework consists of libraries that are contained in assemblies installed in a folder on the machine that runs the app. For self-contained apps, the shared framework assemblies are included with the app.
For more information, see Deep-dive into .NET Core primitives, part 2: the shared framework.
A set of programming technologies that are used together to build and run applications.
"The .NET stack" refers to .NET Standard and all .NET implementations. The phrase "a .NET stack" may refer to one implementation of .NET.
The collection of APIs that a .NET app or library relies on.
An app or library can target a version of .NET Standard (for example, .NET Standard 2.0), which is a specification for a standardized set of APIs across all .NET implementations. An app or library can also target a version of a specific .NET implementation, in which case it gets access to implementation-specific APIs. For example, an app that targets Xamarin.iOS gets access to Xamarin-provided iOS API wrappers.
For some target frameworks (for example, .NET Framework) the available APIs are defined by the assemblies that a .NET implementation installs on a system, which may include application framework APIs (for example, ASP.NET, WinForms). For package-based target frameworks, the framework APIs are defined by the packages installed in the app or library.
See Target Frameworks.
Target framework moniker.
A standardized token format for specifying the target framework of a .NET app or library. Target frameworks are typically referenced by a short name, such as
net462. Long-form TFMs (such as .NETFramework,Version=4.6.2) exist but are not generally used to specify a target framework.
See Target Frameworks.
Universal Windows Platform.
A type of app someone is building. More generic than app model. For example, at the top of every .NET documentation page, including this one, is a drop-down list for Workloads, which lets you switch to documentation for Web, Mobile, Cloud, Desktop, and Machine Learning & Data.
In some contexts, workload refers to a collection of Visual Studio features that you can choose to install to support a particular type of app. For an example, see Select a workload.