Edit

Share via

Tutorial: Get started with ASP.NET Core

  • Article

Note

This isn't the latest version of this article. For the current release, see the .NET 9 version of this article.

Warning

This version of ASP.NET Core is no longer supported. For more information, see the .NET and .NET Core Support Policy. For the current release, see the .NET 9 version of this article.

Important

This information relates to a pre-release product that may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

For the current release, see the .NET 9 version of this article.

This tutorial shows how to create and run an ASP.NET Core web app using the .NET CLI.

For Blazor tutorials, see ASP.NET Core Blazor tutorials.

You'll learn how to:

  • Create a web app project.
  • Run the app.
  • Edit a Razor page.

At the end, you'll have a working web app running on your local machine.

Web app home page

Prerequisites

Create a web app project

Open a command shell, and enter the following command:

dotnet new webapp --output aspnetcoreapp --no-https

The preceding command creates a new web app project in a directory named aspnetcoreapp. The project doesn't use HTTPS.

Run the app

Run the following commands:

cd aspnetcoreapp
dotnet run

The run command produces output like the following example:

Building...
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5109
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\aspnetcoreapp

Open a browser and go to the URL shown in the output. In this example, the URL is http://localhost:5109.

The browser shows the home page.

Web app home page

Edit a Razor page

Change the home page:

  • In the command shell, press Ctrl+C (Cmd+C in macOS) to exit the program.

  • Open Pages/Index.cshtml in a text editor.

  • Replace the line that begins with "Learn about" with the following highlighted markup and code:

    @page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>Hello, world! The time on the server is @DateTime.Now</p>
</div>

  • Save your changes.

  • In the command shell run the dotnet run command again.

  • In the browser, refresh the page and verify the changes are displayed.

    Web app home page showing the change that was made.

Next steps

In this tutorial, you learned how to:

  • Create a web app project.
  • Run the project.
  • Make a change.

To learn more about ASP.NET Core, see the following:

Overview of ASP.NET Core