AspNetCore.Docs/aspnetcore/getting-started/index.md

3.1 KiB
Raw Blame History

title author description ms.author ms.custom ms.date uid
Get started with ASP.NET Core rick-anderson A quick tutorial that creates and runs a simple Hello World app using ASP.NET Core. riande mvc 05/31/2018 getting-started

Tutorial: Get started with ASP.NET Core

This tutorial shows how to use the .NET Core command-line interface to create an ASP.NET Core web app. You'll learn how to:

[!div class="checklist"]

  • Create a web app project.
  • Enable local HTTPS.
  • 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

  • Install the [!INCLUDE ].

Create a web app project

  • Open a command shell, and enter the following command:

    dotnet new webapp -o aspnetcoreapp
    

Enable local HTTPS

  • Trust the HTTPS development certificate:

Windows

dotnet dev-certs https --trust

The preceding command displays the following dialog:

Security warning dialog

Select Yes if you agree to trust the development certificate.

macOS

dotnet dev-certs https --trust

The preceding command displays the following message:

Trusting the HTTPS development certificate was requested. If the certificate is not already trusted we will run the following command: 'sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain <<certificate>>'.
*This command might prompt you for your password to install the certificate on the system keychain.

Password:*

Enter your password if you agree to trust the development certificate.

Linux

See the documentation for your Linux distribution on how to trust the HTTPS development certificate.


Run the app

  • Run the following commands:

    cd aspnetcoreapp
    dotnet run
    
  • Browse to https://localhost:5001. Click Accept to accept the privacy and cookie policy. This app doesn't keep personal information.

Edit a Razor page

  • Open Pages/About.cshtml and modify the page with the following highlighted markup:

    [!code-cshtml]

  • Browse to https://localhost:5001/About and verify the changes are displayed.

Next steps

In this tutorial, you learned how to:

[!div class="checklist"]

  • Create a web app project.
  • Enable local HTTPS.
  • Run the project.
  • Make a change.

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

[!div class="nextstepaction"] xref:index

[!NOTE] Were testing the usability of a proposed new structure for the ASP.NET Core table of contents. If you have a few minutes to try an exercise of finding 7 different topics in the current or proposed table of contents, please click here to participate in the study.