--- title: ASP.NET Core fundamentals author: rick-anderson description: Discover the foundational concepts for building ASP.NET Core apps. ms.author: riande ms.custom: mvc ms.date: 08/20/2018 uid: fundamentals/index --- # ASP.NET Core fundamentals An ASP.NET Core app is a console app that creates a web server in its `Main` method: ::: moniker range=">= aspnetcore-2.0" [!code-csharp[](index/snapshots/2.x/Program.cs)] The `Main` method invokes [WebHost.CreateDefaultBuilder](xref:Microsoft.AspNetCore.WebHost.CreateDefaultBuilder*), which follows the [builder pattern](https://wikipedia.org/wiki/Builder_pattern) to create a web host. The builder has methods that define the web server (for example, ) and the startup class (). In the preceding example, the [Kestrel](xref:fundamentals/servers/kestrel) web server is automatically allocated. ASP.NET Core's web host attempts to run on IIS, if available. Other web servers, such as [HTTP.sys](xref:fundamentals/servers/httpsys), can be used by invoking the appropriate extension method. `UseStartup` is explained further in the next section. , the return type of the `WebHost.CreateDefaultBuilder` invocation, provides many optional methods. Some of these methods include `UseHttpSys` for hosting the app in HTTP.sys and for specifying the root content directory. The and methods build the object that hosts the app and begins listening for HTTP requests. ::: moniker-end ::: moniker range="< aspnetcore-2.0" [!code-csharp[](index/snapshots/1.x/Program.cs)] The `Main` method uses , which follows the [builder pattern](https://wikipedia.org/wiki/Builder_pattern) to create a web app host. The builder has methods that define the web server (for example, ) and the startup class (). In the preceding example, the [Kestrel](xref:fundamentals/servers/kestrel) web server is used. Other web servers, such as [WebListener](xref:fundamentals/servers/weblistener), can be used by invoking the appropriate extension method. `UseStartup` is explained further in the next section. `WebHostBuilder` provides many optional methods, including for hosting in IIS and IIS Express and for specifying the root content directory. The and methods build the object that hosts the app and begins listening for HTTP requests. ::: moniker-end ## Startup The `UseStartup` method on `WebHostBuilder` specifies the `Startup` class for your app: ::: moniker range=">= aspnetcore-2.0" [!code-csharp[](index/snapshots/2.x/Program.cs?highlight=10)] ::: moniker-end ::: moniker range="< aspnetcore-2.0" [!code-csharp[](index/snapshots/1.x/Program.cs?highlight=7)] ::: moniker-end The `Startup` class is where you define the request handling pipeline and where any services needed by the app are configured. The `Startup` class must be public and contain the following methods: ::: moniker range=">= aspnetcore-2.0" [!code-csharp[](index/snapshots/2.x/Startup.cs)] ::: moniker-end ::: moniker range="< aspnetcore-2.0" [!code-csharp[](index/snapshots/1.x/Startup.cs)] ::: moniker-end defines the [Services](#dependency-injection-services) used by your app (for example, ASP.NET Core MVC, Entity Framework Core, Identity). defines the [middleware](xref:fundamentals/middleware/index) called in the request pipeline. For more information, see . ## Content root The content root is the base path to any content used by the app, such as [Razor Pages](xref:razor-pages/index), MVC views, and static assets. By default, the content root is the same location as the app base path for the executable hosting the app. ## Web root The web root of an app is the directory in the project containing public, static resources, such as CSS, JavaScript, and image files. ## Dependency injection (services) A *service* is a component that's intended for common consumption in an app. Services are made available through [dependency injection (DI)](xref:fundamentals/dependency-injection). ASP.NET Core includes a native Inversion of Control (IoC) container that supports [constructor injection](xref:mvc/controllers/dependency-injection#constructor-injection) by default. You can replace the default container if you wish. In addition to its [loose coupling benefit](/dotnet/standard/modern-web-apps-azure-architecture/architectural-principles#encapsulation), DI makes services, such as [logging](xref:fundamentals/logging/index), available throughout your app. For more information, see . ## Middleware In ASP.NET Core, you compose your request pipeline using [middleware](xref:fundamentals/middleware/index). ASP.NET Core middleware performs asynchronous operations on an `HttpContext` and then either invokes the next middleware in the pipeline or terminates the request. By convention, a middleware component called "XYZ" is added to the pipeline by invoking a `UseXYZ` extension method in the `Configure` method. ASP.NET Core includes a rich set of built-in middleware, and you can write your own custom middleware. [Open Web Interface for .NET (OWIN)](xref:fundamentals/owin), which allows web apps to be decoupled from web servers, is supported in ASP.NET Core apps. For more information, see and . ::: moniker range=">= aspnetcore-2.1" ## Initiate HTTP requests is available to access instances to make HTTP requests. For more information, see . ::: moniker-end ## Environments Environments, such as *Development* and *Production*, are a first-class notion in ASP.NET Core and can be set using an environment variable, settings file, and command-line argument. For more information, see . ## Hosting ASP.NET Core apps configure and launch a *host*, which is responsible for app startup and lifetime management. For more information, see . ## Servers The ASP.NET Core hosting model doesn't directly listen for requests. The hosting model relies on an HTTP server implementation to forward the request to the app. The forwarded request is wrapped as a set of feature objects that can be accessed through interfaces. ASP.NET Core includes a managed, cross-platform web server, called [Kestrel](xref:fundamentals/servers/kestrel). Kestrel is commonly run behind a production web server, such as [IIS](https://www.iis.net/) or [Nginx](http://nginx.org) in a reverse proxy configuration. Kestrel can also be run as an edge server exposed directly to the Internet in ASP.NET Core 2.0 or later. For more information, see . ## Configuration ASP.NET Core uses a configuration model based on name-value pairs. The configuration model isn't based on or *web.config*. Configuration obtains settings from an ordered set of configuration providers. The built-in configuration providers support a variety of file formats (XML, JSON, INI), environment variables, and command-line arguments. You can also write your own custom configuration providers. For more information, see . ## Logging ASP.NET Core supports a Logging API that works with a variety of logging providers. Built-in providers support sending logs to one or more destinations. Third-party logging frameworks can be used. For more information, see . ## Error handling ASP.NET Core has built-in scenarios for handling errors in apps, including a developer exception page, custom error pages, static status code pages, and startup exception handling. For more information, see . ## Routing ASP.NET Core offers scenarios for routing of app requests to route handlers. For more information, see . ## File Providers ASP.NET Core abstracts file system access through the use of File Providers, which offers a common interface for working with files across platforms. For more information, see . ## Static files Static Files Middleware serves static files, such as HTML, CSS, image, and JavaScript files. For more information, see . ## Session and app state ASP.NET Core offers several approaches to preserve session and app state while a user browses a web app. For more information, see . ## Globalization and localization Creating a multilingual website with ASP.NET Core allows your site to reach a wider audience. ASP.NET Core provides services and middleware for localizing content into different languages and cultures. For more information, see . ## Request features Web server implementation details related to HTTP requests and responses are defined in interfaces. These interfaces are used by server implementations and middleware to create and modify the app's hosting pipeline. For more information, see . ## Background tasks Background tasks are implemented as *hosted services*. A hosted service is a class with background task logic that implements the interface. For more information, see . ## Access HttpContext `HttpContext` is automatically available when processing requests with Razor Pages and MVC. In circumstances where `HttpContext` isn't readily available, you can access the `HttpContext` through the interface and its default implementation, . For more information, see . ## WebSockets [WebSocket](https://wikipedia.org/wiki/WebSocket) is a protocol that enables two-way persistent communication channels over TCP connections. It's used for apps such as chat, stock tickers, games, and anywhere you desire real-time functionality in a web app. ASP.NET Core supports web socket scenarios. For more information, see . ::: moniker range=">= aspnetcore-2.1" ## Microsoft.AspNetCore.App metapackage The [Microsoft.AspNetCore.App](https://www.nuget.org/packages/Microsoft.AspNetCore.App/) metapackage simplifies package management. For more information, see . ::: moniker-end ::: moniker range="= aspnetcore-2.0" ## Microsoft.AspNetCore.All metapackage The [Microsoft.AspNetCore.All](https://www.nuget.org/packages/Microsoft.AspNetCore.All) metapackage for ASP.NET Core includes: * All supported packages by the ASP.NET Core team. * All supported packages by Entity Framework Core. * Internal and 3rd-party dependencies used by ASP.NET Core and Entity Framework Core. For more information, see . ::: moniker-end ## .NET Core vs. .NET Framework runtime An ASP.NET Core app can target the .NET Core or .NET Framework runtime. For more information, see [Choosing between .NET Core and .NET Framework](/dotnet/articles/standard/choosing-core-framework-server). ## Choose between ASP.NET Core and ASP.NET For more information on choosing between ASP.NET Core and ASP.NET, see .