2.9 KiB

Raw Permalink Blame History

title	author	description	monikerRange	ms.author	ms.custom	ms.date	uid
Get started with ASP.NET Core	tdykstra	A short tutorial using the .NET CLI to create and run a basic Hello World app using ASP.NET Core.	>= aspnetcore-3.1	tdykstra	mvc	05/31/2024	getting-started

Tutorial: Get started with ASP.NET Core

[!INCLUDE]

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

For Blazor tutorials, see xref:blazor/tutorials/index.

You'll learn how to:

[!div class="checklist"]

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.

:::image source="_static/home-page.png" alt-text="Web app home page":::

Prerequisites

:::moniker range=">= aspnetcore-8.0" [!INCLUDE] :::moniker-end :::moniker range=">= aspnetcore-7.0 < aspnetcore-8.0" [!INCLUDE] :::moniker-end :::moniker range="<= aspnetcore-6.0" [!INCLUDE] :::moniker-end

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.

:::image source="_static/home-page.png" alt-text="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:

:::code language="cshtml" source="sample/index.cshtml" highlight="9":::
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.

:::image source="_static/home-page-changed.png" alt-text="Web app home page showing the change that was made.":::

Next steps

In this tutorial, you learned how to:

[!div class="checklist"]

Create a web app project.

Run the project.

Make a change.

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

[!div class="nextstepaction"] xref:index#recommended-learning-path

2.9 KiB Raw Permalink Blame History